Skip to content

README.md

Latest commit

 

History

History
173 lines (143 loc) · 8.09 KB

README.md

File metadata and controls

173 lines (143 loc) · 8.09 KB
Raw

dot-agents

Personal configuration for coding agents.

This repo keeps the durable, reviewable parts of the agent setup in one place: global instructions, declarative settings, portable rules, personal skills, and future hook glue. Runtime state, auth material, histories, caches, and generated artifacts stay out of git.

Layout

  • skills/ - submodule for stanfish06/skillquarium, the reusable skill vault.
  • .github/ - Dependabot and validation automation for advancing the skills submodule pin.
  • agents/ - reusable specialist personas imported from production agent packs.
  • claude/ - selected files from ~/.claude: global instructions, settings, and the standalone graphify skill, plus optional slash commands under claude/commands/. claude/settings.local-llm.json and the claude-local launcher (linked to ~/.local/bin/claude-local) point Claude Code at the llama.cpp server on stanfishdeb over Tailscale; see "Local model" below.
  • codex/ - selected files from ~/.codex: global instructions, config, default rules, hooks, and the hatch-pet skill.
  • pi-agent/ - selected Pi agent config: global AGENTS.md (installed as ~/.pi/agent/AGENTS.md) and the mypi theme.
  • opencode/ - selected opencode config: global AGENTS.md operating guide, opencode.jsonc, tui.json + themes/mypi.json (the Pi theme ported to opencode's theme format). opencode auto-loads skills from ~/.agents/skills/ and ~/.claude/skills/, so no separate skill wiring is needed.
  • kilo/ - Kilo Code config: global AGENTS.md plus kilo.jsonc wired for OpenRouter (BYOK). The API key is read from the OPENROUTER_API_KEY env var, never committed.
  • cursor/ - Cursor user rules translated from codex/AGENTS.md into .mdc files under cursor/rules/, plus a sanitized cli-config.json (approvalMode: unrestricted, i.e. Run Everything). Rules are symlinked to ~/.cursor/rules/*.mdc; the CLI config is copied to ~/.cursor/cli-config.json so the CLI can rewrite caches without dirtying git. Cursor has no home-directory AGENTS.md. Project AGENTS.md / .cursor/rules stay in each repo.
  • apis/ - personal APImanac catalog (catalog/meta, catalog/execution) for APImanac plus SKILL.md fetched from stanfish06/APImanac skill/SKILL.md. The installer writes catalog_root to $XDG_CONFIG_HOME/apimanac/config.yaml and symlinks the skill into each harness skills/apimanac/ directory. Grants stay in the untracked XDG grants file, not here. The apimanac mcp stdio server is registered per harness: [mcp_servers.apimanac] in codex/config.toml, an mcp block in opencode/opencode.jsonc and kilo/kilo.jsonc, user scope via claude mcp add for Claude, and a merged entry in ~/.cursor/mcp.json. Pi has no native MCP support.
  • prompts/ - reusable system prompts and live prompt templates for agent slash-command surfaces.
  • hooks/ - opt-in Claude hook scripts and hook JSON examples.
  • scripts/ - reserved for install, refresh, and validation helpers.
  • spec/ - notes and future harness experiments for spec-driven development (catalog of mainstream SDD tools, local templates later). See spec/README.md.
  • docs/sources.md - notes from the reference repos and the local import.

First Checkout

git submodule update --init --recursive

The skills/ submodule is intentionally separate from the agent-specific config folders. Agent harnesses can symlink or install skills from that vault while this repo also tracks harness configuration around them.

Automatic Skills Updates

The skills/ submodule tracks the master branch of stanfish06/skillquarium. Dependabot checks it daily and opens an update pull request when the recorded commit is behind. A narrowly scoped workflow verifies that the pull request changes only the skills gitlink, checks the submodule and installer contract, and merges it when those checks pass.

After pulling this repository, update the local checkout to its newly recorded pin:

git pull --recurse-submodules

To fetch the current upstream head before Dependabot advances the remote pin:

git submodule update --init --remote --checkout skills

Install

./scripts/install.sh

The installer is symlink-first for agent config. It initializes the skills/ submodule, delegates skill installation to skills/install-skills.sh, then links the selected Claude, Codex, Pi, opencode, Kilo Code, and Cursor config into their agent homes. It fetches skill/SKILL.md from stanfish06/APImanac into apis/SKILL.md, writes the APImanac catalog_root, symlinks that file into each harness skills/apimanac/ directory, and registers the apimanac mcp server for Claude (user scope) and Cursor. It also links prompts/live-prompts/*.md into each agent's live prompt or command directory. Existing non-matching files are moved aside to timestamped backups.

The skills installer skips the optional gstack and career-ops extras by default. Select either or both through the parent installer:

./scripts/install.sh --extras gstack
./scripts/install.sh --extras career
./scripts/install.sh --extras gstack career
./scripts/install.sh --extras all

Preview changes without touching your home directory:

./scripts/install.sh --dry-run

Local model

claude-local runs Claude Code against the llama.cpp server on stanfishdeb (https://stanfishdeb.tail861ef1.ts.net, Anthropic-compatible /v1/messages, currently qwen3-4b with a 40960-token context). It passes --settings claude/settings.local-llm.json --strict-mcp-config --bare, so no hooks, plugins, MCP servers, CLAUDE.md, or auto-memory load. Bare mode exposes only Bash, Edit, and Read (about 900 tokens) behind a two-line system prompt, so the launcher appends a short instruction telling the model to act through those tools instead of printing commands; the whole prompt stays near 1.2k tokens. CLAUDE_LOCAL_FULL=1 drops --bare and loads the normal profile: 24 tools (about 12k tokens), the full system prompt, and CLAUDE.md, about 23k of the 40k window before the first message.

claude-local
claude-local -p "explain this repo"
CLAUDE_LOCAL_FULL=1 claude-local

Model name, URL, and context size live in claude/settings.local-llm.json (ANTHROPIC_MODEL, ANTHROPIC_BASE_URL, CLAUDE_CODE_MAX_CONTEXT_TOKENS under env). The server ignores the Anthropic thinking parameter, so Qwen3 reasons on every turn unless llama-server runs with --reasoning-budget 0. Claude Code sends no sampling parameters, so the server defaults apply (temperature 0.8, top-k 40); Qwen's published settings for tool use are --temp 0.7 --top-p 0.8 --top-k 20 --min-p 0, and a 4B model at 0.8 will sometimes print a command as text instead of calling the tool.

Imported Reference Content

The submodule includes the selected production engineering skills from addyosmani/agent-skills, excluding the duplicate test-driven-development skill because the vault already carries the Superpowers version. The parent repo also keeps Addy's specialist personas, Claude slash commands, and opt-in hooks.

The hooks/ directory also carries the Superpowers session-start bootstrap hook as an opt-in reference. Do not enable both session-start bootstraps at once unless you explicitly want both meta-skill introductions injected into every session.

The Claude and Codex stop-summary hooks from stanfish06/my-configs are included as repo-managed scripts. They send a simple desktop notification by default; set DOT_AGENTS_STOP_SUMMARY_WITH_CLAUDE=1 to let them ask Claude for a short stop summary before notifying.

prompts/system-prompts/deer-flow/ holds portable prompt templates extracted from bytedance/deer-flow 2.0 (MIT) — the lead-agent system prompt, a subagent orchestration prompt, and structured memory-management prompts. The deer-flow skills/public set is being imported separately into the stanfish06/skillquarium vault rather than here, per the skills-go-in-the-submodule rule.