fix(i3): window startup

.agent/COMMITS.md

@@ -0,0 +1,8 @@
+Commits
+## Commit Message Format
+Follow conventional commits style (all lowercase).
+- `feat(scope): description` - New feature
+- `fix(scope): description` - Bug fix
+- `refactor(scope): description` - Code refactoring
+- `docs(scope): description` - Documentation changes
+- Example: `feat(zsh): update dotfiles` or `fix(scripts): use correct pass entry`

.chezmoiroot

@@ -0,0 +1 @@
+home

.gitignore

@@ -1,142 +0,0 @@
-i3/.config/i3/config
-settings.conf
-systemd/user/*/*
-
-# Byte-compiled / optimized / DLL files
-__pycache__/
-*.py[cod]
-*$py.class
-
-# C extensions
-*.so
-
-# Distribution / packaging
-.Python
-build/
-develop-eggs/
-dist/
-downloads/
-eggs/
-.eggs/
-lib/
-lib64/
-parts/
-sdist/
-var/
-wheels/
-share/python-wheels/
-*.egg-info/
-.installed.cfg
-*.egg
-MANIFEST
-
-# PyInstaller
-#  Usually these files are written by a python script from a template
-#  before PyInstaller builds the exe, so as to inject date/other infos into it.
-*.manifest
-*.spec
-
-# Installer logs
-pip-log.txt
-pip-delete-this-directory.txt
-
-# Unit test / coverage reports
-htmlcov/
-.tox/
-.nox/
-.coverage
-.coverage.*
-.cache
-nosetests.xml
-coverage.xml
-*.cover
-*.py,cover
-.hypothesis/
-.pytest_cache/
-cover/
-
-# Translations
-*.mo
-*.pot
-
-# Django stuff:
-*.log
-local_settings.py
-db.sqlite3
-db.sqlite3-journal
-
-# Flask stuff:
-instance/
-.webassets-cache
-
-# Scrapy stuff:
-.scrapy
-
-# Sphinx documentation
-docs/_build/
-
-# PyBuilder
-.pybuilder/
-target/
-
-# Jupyter Notebook
-.ipynb_checkpoints
-
-# IPython
-profile_default/
-ipython_config.py
-
-# pyenv
-#   For a library or package, you might want to ignore these files since the code is
-#   intended to run in multiple environments; otherwise, check them in:
-# .python-version
-
-# pipenv
-#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
-#   However, in case of collaboration, if having platform-specific dependencies or dependencies
-#   having no cross-platform support, pipenv may install dependencies that don't work, or not
-#   install all needed dependencies.
-#Pipfile.lock
-
-# PEP 582; used by e.g. github.com/David-OConnor/pyflow
-__pypackages__/
-
-# Celery stuff
-celerybeat-schedule
-celerybeat.pid
-
-# SageMath parsed files
-*.sage.py
-
-# Environments
-.env
-.venv
-env/
-venv/
-ENV/
-env.bak/
-venv.bak/
-
-# Spyder project settings
-.spyderproject
-.spyproject
-
-# Rope project settings
-.ropeproject
-
-# mkdocs documentation
-/site
-
-# mypy
-.mypy_cache/
-.dmypy.json
-dmypy.json
-
-# Pyre type checker
-.pyre/
-
-# pytype static type analyzer
-.pytype/
-
-# Cython debug symbols
-cython_debug/

AGENTS.md

@@ -0,0 +1,147 @@
+# AGENTS.md - Coding Guidelines for Agentic Operations
+
+This repository is a personal dotfiles collection managed with [chezmoi](https://www.chezmoi.io). It contains configuration files, shell scripts, and Python utilities for system management.
+
+## Build, Lint & Test Commands
+
+### Running Scripts
+- **Shell scripts**: `bash ./home/bin/executable_<script_name>.sh` or run directly if executable
+- **Python scripts**: `python3 ./home/bin/<script_name>.py`
+- **Install dependencies**: `pip install -r requirements.txt`
+
+### Testing
+No formal test framework is present. Validation is done by:
+- Running scripts manually with test inputs
+- Checking for runtime errors (e.g., `python3 -m py_compile <file>` for syntax)
+- Verifying command outputs match expected behavior
+
+### Single Test/Script Execution
+```bash
+# Run a single Python script
+python3 ./home/bin/i3-mouse.py
+
+# Run a single shell script
+bash ./home/bin/executable_update.sh
+
+# Check Python syntax without running
+python3 -m py_compile ./home/bin/homeassistant.py
+```
+
+## Code Style Guidelines
+
+### Python
+
+#### Imports
+- Use standard library imports first, then third-party imports, then local imports
+- Import order: `os`, `sys`, `time` → `requests`, `i3ipc`, `pyautogui` → local modules
+- Each import on its own line (avoid `import x, y, z`)
+- Example:
+  ```python
+  #!/usr/bin/env python3
+  import os
+  import sys
+  import datetime
+  from requests import get, post
+  import json
+  ```
+
+#### Naming Conventions
+- **Functions**: `snake_case` (e.g., `getPoints()`, `pointsToDirection()`)
+- **Classes**: `PascalCase` (e.g., `HomeAssistant`, `Direction`)
+- **Constants**: `UPPER_SNAKE_CASE`
+- **Private members**: prefix with underscore `_privateVar`
+- Enums use `PascalCase` for class and `UPPER_SNAKE_CASE` for members
+
+#### Formatting
+- Use 4-space indentation (not tabs)
+- Line length: Keep to reasonable length (~80-100 chars) where practical
+- Shebang for executable scripts: `#!/usr/bin/env python3`
+- Blank lines: 2 between top-level definitions, 1 between method definitions
+
+#### Types & Documentation
+- No type hints required (not present in codebase)
+- Add docstring comments for classes and non-obvious functions
+- Comment format: `# description` (no colons at end unless explaining)
+- Example: `# Enum for mouse direction`
+
+#### Error Handling
+- Use `raise` for exceptions in API wrappers (e.g., `response.raise_for_status()`)
+- Return `None` for optional/conditional operations
+- Handle command availability checks: `if command -v <cmd> &> /dev/null`
+
+### Shell Scripts
+
+#### Shebang & Headers
+- Start with: `#!/bin/bash`
+- Add brief comment: `# Script purpose description`
+
+#### Formatting
+- Use 2-space indentation
+- Quote variables: `"${variable}"` or `"$variable"`
+- Use `function name { ... }` syntax for functions
+
+#### Naming & Structure
+- Function names: `snake_case`
+- Variables: lowercase with underscores for clarity
+- Check for command availability before use:
+  ```bash
+  if command -v <cmd> &> /dev/null; then
+      <cmd> <args>
+  fi
+  ```
+
+#### Error Handling
+- Use `set -e` to exit on error when appropriate
+- Check command exit status: `if <command>; then ... fi`
+- Redirect stderr appropriately: `2>/dev/null` or `2>&1`
+
+### Configuration Files
+- Before generating a commit, always consult `.agent/COMMITS.md` for the required style.
+
+#### chezmoi Templates
+- Dotfiles use chezmoi's templating system
+- Template syntax: `{{ }}` for variables (Chezmoi specific)
+- File naming: `dot_` prefix for dotfiles (e.g., `dot_zshrc`)
+- Executable scripts: `executable_` prefix
+
+#### Comments
+- Use `#` for all config file comments
+- Keep comments concise and descriptive
+
+## Repository Patterns
+
+### Commit Message Format
+Follow conventional commits style (all lowercase).
+- `feat(scope): description` - New feature
+- `fix(scope): description` - Bug fix
+- `refactor(scope): description` - Code refactoring
+- `docs(scope): description` - Documentation changes
+- Example: `feat(zsh): update dotfiles` or `fix(scripts): use correct pass entry`
+
+#### Pushing Remotes
+- **Do not push git repositories to remote unless explicitly instructed.**
+
+### File Organization
+- Shell scripts: `home/bin/executable_<name>.sh`
+- Python scripts: `home/bin/<name>.py`
+- Config files: `home/dot_config/<app>/` (following XDG spec)
+- Dependencies: List in `requirements.txt`
+
+## Key Dependencies
+
+- **configparser** - Config file parsing
+- **todoist-python** - Todoist API
+- **tbapy** - TBA API for robotics
+- **holidays** - Holiday detection
+- **i3ipc** - i3 window manager control
+- **pyautogui** - Mouse control
+- **requests** - HTTP library
+- **dateutil** - Date utilities
+
+## Development Notes
+
+- This is a personal configuration repository, not a library
+- Scripts are system-level utilities and automation scripts
+- No CI/CD pipeline present (manual validation)
+- Target OS: Linux (Ubuntu/Fedora compatible)
+- Python version: Python 3.x minimum

README.md

@@ -2,20 +2,9 @@
 
 A collection of config files and scripts for Fedora GNU/Linux.
 
-## Install
+## Installation
 
-Run the following command to install
+```bash
-
+chezmoi init --apply git@github.com:AquaMorph/dotfiles.git
-```sh
-cd ~ && git clone git@github.com:AquaMorph/dotfiles.git && sh ~/dotfiles/install.sh
 ```
 
-## Scripts
-
-### frc-photo-checklist.py
-
-Python script to generate a Todoist checklist for taking photos at an FRC event.
-
-```sh
-python frc-photo-checklist.py [Event Key]
-```

home/.chezmoitemplates/models/big-brain

@@ -0,0 +1 @@
+AquaAI/glm-4.7-flash

home/.chezmoitemplates/prompts/agent-name

@@ -0,0 +1 @@
+AquaAI

home/.chezmoitemplates/prompts/better-conversations

@@ -0,0 +1,7 @@
+Be as concise as possible.
+Be extremely accurate.
+Recommend things I would not realize I would benefit from.
+Call out my misconceptions and tell me when I am wrong.
+For personal matters {{ template "prompts/agent-name" . }} is encouraging but brutally honest.
+Never sycophantic.
+Do not use em dashes. If an em dash would normally appear, use a comma for continuing thoughts or a period if it should be a separate sentence.

home/.chezmoitemplates/prompts/name

@@ -0,0 +1 @@
+You are an AI assistant named {{ template "prompts/agent-name" . }}.

home/bin/README.md

@@ -0,0 +1,25 @@
+# Scripts
+
+## AquaAI
+
+AquaAI is bash script that interacts with OpenAI and Ollama APIs to enable terminal based interaction with LLMs.
+
+## connect-nas.sh
+
+Connect to long storage NAS.
+
+## convert-mp4-to-resolve.sh
+
+Converts mp4 video files to a video format where the audio works with the linux version of Davinci Resolve.
+
+## frc-photo-checklist.py
+
+Python script to generate a Todoist checklist for taking photos at an FRC event.
+
+```sh
+python frc-photo-checklist.py [Event Key]
+```
+
+## get-mouse-battery.sh
+
+Prints out the battery percentage of a mouse and if it is charging.

home/bin/audio/executable_system-start-audio.sh

@@ -22,15 +22,6 @@ function fixPulse() {
     fi
 }
 
-# Start up programs that use audio.
-function launchi3() {
-    if [ -z "$skipi3" ]; then
-	echo Opening i3wm sound workspaces
-	sleep .1 && i3-msg 'workspace 5; exec brave-browser'
-	#sleep 5.1 && python ~/bin/start-firefox.py
-    fi
-}
-
 # Set up sinks.
 function setupSinks() {
     pactl set-default-sink speakers
@@ -66,23 +57,12 @@ function restartWireplumber() {
     systemctl --user restart wireplumber
 }
 
-# arg parser
-for arg in "$@"
-do
-    # Skip commands for i3wm
-    if [[ $arg == *"-s"* ]]; then
-	skipi3=true
-    fi
-done
-
 # Wire sinks
 setupSinks
 
 # Eurorack audio interface
 sh ~/bin/audio/es9start.sh
 
-launchi3
 systemctl --user restart polybar
 sleep 5
 restartWireplumber
-

home/bin/executable_aquaai.sh

@@ -74,7 +74,7 @@
 #
 # export AQUAAI_OLLAMA_URL='192.168.1.156:11434'
 #
-ollama_url=${AQUAAI_OLLAMA_URL:='https://ai.aquamorph.com'}
+ollama_url=${AQUAAI_OLLAMA_URL:='https://ai.aquamorph.com/api'}
 #
 # Set the default model.
 #
@@ -178,6 +178,9 @@ function set_better_conversions() {
   system_prompt+=" For personal matters ${AGENT_NAME} is encouraging"
   system_prompt+=' but brutally honest.'
   system_prompt+=' Never sycophantic.'
+  system_prompt+=' Do not use em dashes. If an em dash would normally appear,'
+  system_prompt+=' use a comma for continuing thoughts or a period if it'
+  system_prompt+=' should be a separate sentence.'
 }
 
 # Set the formatting for all reponses.
@@ -369,9 +372,9 @@ function check_requirements() {
 function get_models() {
   local model_path=''
   if [ "${openai_api}" == true ]; then
-    model_path='/api/models'
+    model_path='/models'
   else
-    model_path='/api/tags'
+    model_path='/tags'
   fi
   curl "${CURL_FLAGS[@]}" "${OLLAMA_URL}${model_path}"
 }
@@ -801,7 +804,7 @@ function chat() {
   local filter=''
   if [ "${openai_api}" == true ]; then
     flags+=(-H "Content-Type: application/json")
-    chat_path='/api/chat/completions'
+    chat_path='/chat/completions'
     filter='.choices[].delta.content // empty'
   else
     chat_path='/api/chat'

home/bin/executable_start-brave.sh

@@ -0,0 +1,29 @@
+#!/bin/bash
+# Restore Brave and place its windows after they finish opening.
+
+preferences="$HOME/.config/BraveSoftware/Brave-Browser/Default/Preferences"
+
+function enable_session_restore {
+  if [ ! -f "$preferences" ] || ! command -v jq &> /dev/null; then
+    return
+  fi
+
+  temp_file="$(mktemp "${preferences}.XXXXXX")"
+  if jq '.session.restore_on_startup = 1 | .profile.exit_type = "Normal"' \
+    "$preferences" > "$temp_file"; then
+    mv "$temp_file" "$preferences"
+  else
+    rm -f "$temp_file"
+  fi
+}
+
+enable_session_restore
+i3-msg 'workspace 9; append_layout ~/.config/i3/brave-workspace-9.json; workspace 5'
+brave-browser --restore-last-session &
+
+# Brave creates restored windows asynchronously and after startup focus has moved.
+for _ in {1..20}; do
+  sleep 0.5
+  i3-msg '[class="^Brave-browser$" workspace="^(?!9$).*"] move to workspace 5' \
+    > /dev/null
+done

home/bin/executable_update.sh

@@ -2,6 +2,14 @@
 
 # This script is a catch all program updater.
 
+# Chezmoi Updater
+function chezmoiUpdate {
+    if command -v chezmoi &> /dev/null; then
+	echo Updating chezmoi dotfiles...
+	chezmoi update
+    fi
+}
+
 # DNF Updater
 function dnfUpdate {
     if command -v dnf &> /dev/null; then
@@ -33,6 +41,15 @@ function appimageUpdate {
     am update
 }
 
+# Pass Repository Updater
+function passUpdate {
+    if [ -d "$HOME/.password-store/.git" ] && [ -d "$HOME/.password-store" ]; then
+        echo Updating pass repository...
+        cd "$HOME/.password-store"
+        git pull
+    fi
+}
+
 # Checks if a program is installed and if it is runs an updater script
 function updateProgram {
     if command -v $1 &> /dev/null; then
@@ -55,6 +72,8 @@ function manualUpdate {
     fi
 }
 
+chezmoiUpdate
+echo ''
 dnfUpdate
 aptUpdate
 echo ''
@@ -63,4 +82,6 @@ echo ''
 appimageUpdate
 echo ''
 manualUpdate
+echo ''
+passUpdate
 

home/bin/frc-photo-checklist.py

@@ -9,13 +9,15 @@ import operator
 import os
 import sys
 import tbapy
-import todoist
+from todoist_api_python.api import TodoistAPI
 
 # getProjectID() returns the project id that matches the name given.
 def getProjectID(api, name):
-    for project in api.state['projects']:
+    projectPages = api.get_projects()
-        if project['name'] == name:
+    for projectList in projectPages:
-            return project['id']
+        for project in projectList:
+            if project.name == name:
+                return project.id
     print('Error: No project with the name {} found'.format(name))
     exit(1)
 
@@ -25,10 +27,12 @@ def getChecklistName(evemt):
 
 # getEventListID() returns the id of the checklist for the event and if there is none
 # returns -1.
-def getEventListID(items, event):
+def getEventListID(api, projectID, event):
-    for item in items:
+    taskPages = api.get_tasks(project_id=projectID)
-        if item['content'] == getChecklistName(event):
+    for taskLists in taskPages:
-            return item['id']
+        for task in taskLists:
+            if task.content == getChecklistName(event):
+                return task.id
     return -1
 
 # matchToTeamList() converts a match to two lists of teams
@@ -37,11 +41,11 @@ def matchToTeamList(match):
 
 # createChecklistItem() creates a checklist item of the highest priority.
 def createChecklistItem(name, api, projectID, item, date):
-    return api.items.add(name,
+    return api.add_task(name,
-                         project_id=projectID,
+                        project_id=projectID,
-                         parent_id=item['id'],
+                        parent_id=item.id,
-                         date_string=date,
+                        due_string=date,
-                         priority=4)
+                        priority=4)
 
 # createPhotoChecklistItem() creates a checklist item that requires a photo.
 def createPhotoChecklistItem(name, api, projectID, item, date):
@@ -50,10 +54,10 @@ def createPhotoChecklistItem(name, api, projectID, item, date):
 
 # createPitList() creates a checklist for taking photos of a teams pit.
 def createPitList(api, teams, projectID, checklist, date):
-    item = api.items.add('**Take** Pit Photos',
+    item = api.add_task('**Take** Pit Photos',
                          project_id=projectID,
-                         parent_id=checklist['id'],
+                         parent_id=checklist.id,
-                         date_string=date,
+                         due_string=date,
                          priority=3)
     for team in teams:
         createChecklistItem('Pit photo of **{}** {}'.format(team['team_number'], team['nickname']),
@@ -61,11 +65,11 @@ def createPitList(api, teams, projectID, checklist, date):
         
 # createGroupsList() creates a checklist of the different groups of volenteers.
 def createGroupsList(api, projectID, checklist, date):
-    item = api.items.add('Groups',
+    item = api.add_task('Groups',
-                         project_id=projectID,
+                        project_id=projectID,
-                         parent_id=checklist['id'],
+                        parent_id=checklist.id,
-                         date_string=date,
+                        due_string=date,
-                         priority=3)
+                        priority=3)
     groups = ['Judges', 'Robot Inspectors', 'Referees', 'Safety Inspectors',
               'Field Reset', 'Queuers', 'CSAs', 'VC and Pit Admin']
     for group in groups:
@@ -73,29 +77,29 @@ def createGroupsList(api, projectID, checklist, date):
 
 # createWinnersList() creates a checklist of the winners of an event.
 def createWinnersList(api, projectID, checklist, date):
-    item = api.items.add('Winners',
+    item = api.add_task('Winners',
-                         project_id=projectID,
+                        project_id=projectID,
-                         parent_id=checklist['id'],
+                        parent_id=checklist.id,
-                         date_string=date,
+                        due_string=date,
-                         priority=3)
+                        priority=3)
-    groups = ['Chairman\'s award', 'Engineering Inspiration', 'Rookie All-Star', 'Winning Alliance',
+    groups = ['Impact', 'Engineering Inspiration', 'Rookie All-Star', 'Winning Alliance',
               'Winning Team 1', 'Winning Team 2', 'Winning Team 3']
     for group in groups:
         createPhotoChecklistItem(group, api, projectID, item, date)
 
 # createRobotList() creates a checklist for taking photos of a team's robot.
 def createRobotList(api, teams, projectID, checklist, date):
-    item = api.items.add('**Take** Robot Photos',
+    item = api.add_task('**Take** Robot Photos',
-                         project_id=projectID,
+                        project_id=projectID,
-                         parent_id=checklist['id'],
+                        parent_id=checklist.id,
-                         date_string=date,
+                        due_string=date,
-                         priority=3)
+                        priority=3)
     for team in teams:
         createChecklistItem('Robot photo of **{}** {}'.format(team['team_number'], team['nickname']),
                             api, projectID, item, date)
         
 # Parse settings config
-configString = '[Settings]\n' + open('../settings.conf').read()
+configString = '[Settings]\n' + open('./.config/settings.conf').read()
 configParser = configparser.RawConfigParser()
 configParser.read_string(configString)
 
@@ -104,10 +108,8 @@ tbaKey = configParser.get('Settings', 'TBAKey')
 todoistToken = configParser.get('Settings', 'TodoistToken')
 
 # Setup Todoist
-api = todoist.TodoistAPI(todoistToken)
+api = TodoistAPI(todoistToken)
-api.sync()
 projectID = getProjectID(api, '🤖 Robotics')
-items = api.state['items']
 
 # Setup the Blue Alliance
 tba = tbapy.TBA(tbaKey)
@@ -128,13 +130,13 @@ def firstMatch(team, matches):
     return None, None
 
 # Check if list already exists
-eventListID = getEventListID(items, event)
+eventListID = getEventListID(api, projectID, event)
 if eventListID == -1:
     # Create checklist
-    checklist = api.items.add(getChecklistName(event),
+    checklist = api.add_task(getChecklistName(event),
-                              project_id=projectID,
+                             project_id=projectID,
-                              date_string=day2,
+                             due_string=day2,
-                              priority=2)
+                             priority=2)
     # Setup
     createPitList(api, teams, projectID, checklist, setupDay)
     createChecklistItem('**Schedule** Judges photo', api, projectID, checklist, setupDay)
@@ -170,4 +172,3 @@ else:
                     matchNumber = match['match_number']
                     matchTime = dt.datetime.fromtimestamp(match['time']).strftime('%Y-%m-%d %I:%M %p')
                     robot.update(date_string=matchTime, content='{} match {} {}'.format(robot['content'], matchNumber, side))
-api.commit()