feat(agents): agents.md directives + tweaks to opencode

Author: scottames

AGENTS.md

@@ -0,0 +1,185 @@
+# AGENTS.md
+
+Agent instructions for the `scottames/dots` repository.
+
+## Project Overview
+
+This is a **dotfiles repository** managed by [chezmoi](https://www.chezmoi.io/).
+The `home/` directory (defined in `.chezmoiroot`) contains templates and files
+that chezmoi uses to manage dotfiles in the user's home directory.
+
+**Key directories:**
+
+- `home/` - Chezmoi source directory (maps to `~`)
+- `home/.chezmoiscripts/` - Scripts run by chezmoi during apply
+- `home/private_dot_config/` - Config files (maps to `~/.config/`)
+- `aqua/` - CLI tool version management via aqua
+- `nix/` - Nix/Darwin configuration (macOS only)
+- `.dagger/` - Dagger module for container-based testing
+- `.trunk/` - Trunk.io linter configurations
+
+## Build/Lint/Test Commands
+
+### Linting (Primary)
+
+Trunk.io is the primary linter orchestrator. All linting should go through
+trunk:
+
+```bash
+# Check all files
+trunk check
+
+# Check specific file(s)
+trunk check path/to/file
+
+# Auto-format all files
+trunk fmt
+
+# Auto-format specific file(s)
+trunk fmt path/to/file
+```
+
+### Testing
+
+Test chezmoi init in a container (requires dagger):
+
+```bash
+dagger call -m . init
+```
+
+### Chezmoi
+
+**IMPORTANT:** Never run `chezmoi apply` unless explicitly directed by the user.
+This modifies the user's home directory and should only be done intentionally.
+
+```bash
+# Preview what would change (safe)
+chezmoi diff
+
+# Verify templates render correctly (safe)
+chezmoi execute-template < file.tmpl
+```
+
+## Code Style Guidelines
+
+### General (EditorConfig)
+
+- **Charset:** UTF-8
+- **Line endings:** LF (Unix)
+- **Final newline:** Always
+- **Indent:** 2 spaces (default)
+- **Max file length:** 200-300 lines, refactor beyond this
+
+Exceptions defined in `.editorconfig`:
+
+- Go, Makefile: tabs, 4-space width
+- Python, Dockerfile: 4 spaces
+
+### Shell Scripts (Bash)
+
+Linters: `shellcheck`, `shfmt`
+
+```bash
+#!/usr/bin/env bash
+
+set -eufo pipefail  # Strict mode for .tmpl scripts
+
+# Color definitions (common pattern)
+magenta='\033[0;35m'
+red='\033[0;31m'
+yellow='\033[0;33m'
+clear='\033[0m'
+
+# Helper functions
+info() { printf "${magenta}%s${clear}\n" "${@}"; }
+err() { printf "${red}%s${clear}\n" "${@}"; exit 1; }
+warn() { printf "${yellow}%s${clear}\n" "${@}"; }
+```
+
+- Use `#!/usr/bin/env bash` shebang
+- Quote variables: `"${var}"` not `$var`
+- Use `[[ ]]` for conditionals, not `[ ]`
+- Use `$(command)` not backticks
+- Shellcheck directives in `.trunk/configs/.shellcheckrc`
+
+### YAML
+
+Linters: `yamllint`, `prettier`
+
+- Quotes: only when needed
+- No empty values in block/flow mappings
+- 1 space minimum after comments
+
+### Go
+
+Linters: `gofmt`, `golangci-lint`
+
+- Standard Go formatting (tabs)
+- Import order: stdlib, external, internal
+
+### Lua (Neovim configs)
+
+Linter: `stylua`
+
+- 2-space indentation
+- Add file mode line: `-- vi: ft=lua`
+
+### Python
+
+Linters: `black`, `isort`, `ruff`, `bandit`
+
+- 4-space indentation
+- Black formatting
+- Select rules: B, D3, E, F (see `.trunk/configs/ruff.toml`)
+
+### Nix
+
+Linter: `nixpkgs-fmt`
+
+- Standard nix formatting
+
+### Markdown
+
+Linter: `markdownlint`
+
+- Formatter-friendly config (formatting rules disabled)
+- Let prettier handle formatting
+
+## Chezmoi Conventions
+
+### File Naming Prefixes
+
+Chezmoi uses special prefixes in `home/`:
+
+- `dot_` - Creates dotfile (e.g., `dot_bashrc` -> `~/.bashrc`)
+- `private_` - Sets restrictive permissions (0600/0700)
+- `executable_` - Sets executable bit
+- `symlink_` - Creates symlink
+- `*.tmpl` - Go template, rendered during apply
+
+### Chezmoi Scripts (`.chezmoiscripts/`)
+
+[docs](https://www.chezmoi.io/user-guide/use-scripts-to-perform-actions/)
+
+> chezmoi supports scripts that are executed when you run chezmoi apply. These
+> scripts can be configured to run every time, only when their contents have
+> changed, or only if they haven't been run before.
+
+- `run_once_` - Run once per content hash
+- `run_onchange_` - Run when watched files change
+- `run_once_after_XX_name.sh.tmpl` - Numbered for ordering
+
+### Templates
+
+Templates use Go text/template syntax with chezmoi extensions:
+
+```text
+{{ .chezmoi.os }}           # Operating system
+{{ .chezmoi.hostname }}     # Machine hostname
+{{ if eq .host.os "linux" }}
+  # Linux-specific content
+{{ end }}
+```
+
+Use `chezmoi data` to view available data (pulls from `home/.chezmoi.toml`
+written to `~/.config/chezmoi/chezmoi.toml` by chezmoi)

home/private_dot_config/agents/core/02_environment.md

@@ -9,7 +9,8 @@ Some wrappers may cause commands to behave strangely, use absolute paths (e.g.
 `/bin/ls`) or prepend `command` (e.g. `command ls`) for these specific and any
 others you get weird behavior with.
 
-- `ls` (wraps `eza`, agent call causes errors)
+- `cd` (wraps zoxide)
+- `ls` (wraps `eza`)
 - `rm` (alias uses `-i` for safety, blocks agent use)
 
 ## Git

home/private_dot_config/opencode/opencode.json

@@ -1,8 +1,33 @@
 {
   "$schema": "https://opencode.ai/config.json",
   "autoupdate": false,
+  "default_agent": "plan",
   "keybinds": {
     "command_list": "ctrl+.",
     "leader": "ctrl+o"
-  }
+  },
+  "model": "anthropic/claude-opus-4-5",
+  "small_model": "anthropic/claude-haiku-4-5",
+  "permission": {
+    "edit": "allow",
+    "bash": {
+      "*": "ask",
+      "cat*": "allow",
+      "git status": "allow",
+      "git mv*": "allow",
+      "ls*": "allow",
+      "/bin/ls*": "allow",
+      "pwd": "allow",
+      "cargo info*": "allow"
+    },
+    "skill": "ask",
+    "webfetch": "ask",
+    "doom_loop": "ask",
+    "external_directory": "ask"
+  },
+  "server": {
+    "hostname": "127.0.0.1",
+    "mdns": false
+  },
+  "share": "disabled"
 }