diff --git a/agents/README.md b/agents/README.md index e537328a..ab3877d9 100644 --- a/agents/README.md +++ b/agents/README.md @@ -21,7 +21,8 @@ Keep one canonical home for each fact; link between layers instead of copying pa - `AGENTS.md`: global baseline rules for coding agents. - `evals/global-rules.md`: behavioral scenarios for validating changes to the global rules. -- `install-skills.md`: curated `npx skills` command snippets, plus the `npx ctx7` docs-tool setup. +- `install-tooling.md`: curated install snippets for external agent tooling (`npx skills`, + `npx ctx7`, tuios integration). The Nix side of the agents — deploying these rules, the agent CLIs, and their environment — lives in the Home Manager module [`home/base/tui/agents/`](../home/base/tui/agents/README.md). @@ -32,7 +33,7 @@ the Home Manager module [`home/base/tui/agents/`](../home/base/tui/agents/README 2. Configure permissions directly in the agent runtime; auto-approval is generally used. 3. Edit the rules; Home Manager links them out-of-store, so the change reaches the next agent session without a rebuild. Run a Home Manager switch only when the deployed target set changes. -4. Use `install-skills.md` as a reference when installing external skills. +4. Use `install-tooling.md` as a reference when installing external agent tooling. ## Deployment @@ -52,7 +53,7 @@ not deployed. Auto-approval controls tool prompting. The global rules still define task authorization, safety, and secret handling. -## About `install-skills.md` +## About `install-tooling.md` Use it as a snippet library: diff --git a/agents/install-skills.md b/agents/install-tooling.md similarity index 84% rename from agents/install-skills.md rename to agents/install-tooling.md index 4374953d..a79a48e4 100644 --- a/agents/install-skills.md +++ b/agents/install-tooling.md @@ -1,7 +1,8 @@ -# Agent Skills Commands +# Agent Tooling Commands -Reference commands for listing, installing, and updating skills via `npx skills`. Keep the global -set small and install task-specific skills in the relevant project. +Reference commands for installing external agent tooling: skills via `npx skills`, the `ctx7` docs +tool, and the tuios harness integration. Keep the global set small and install task-specific skills +in the relevant project. This repository's own skills live in `.agents/skills/`: they are tracked in git and discovered automatically, so do not install, overwrite, or remove them with `npx skills`. The commands below @@ -56,9 +57,6 @@ npx skills add -g JuliusBrussee/caveman --skill 'caveman' # shape replies for an ADHD reader: next action first, numbered steps, restated state npx skills add -g ayghri/i-have-adhd --skill 'i-have-adhd' - -# inspect and control herdr panes, tabs, workspaces, agents, and commands from a herdr pane -npx skills add -g herdrdev/herdr --skill 'herdr' ``` ## Optional project skills @@ -81,11 +79,15 @@ npx skills add anthropics/skills --skill 'pdf' npx skills add trailofbits/skills --skill 'codeql' --skill 'semgrep' ``` -## Other agent tooling (npx) +## Other agent tooling ```bash # context7: up-to-date library docs and code examples for LLMs and agents npx ctx7 setup + +# tuios: register it as an MCP server for the harness (read-only, or --mcp-write +# for typing tools); also reports agent state into the tuios pane +tuios integration install opencode --mcp-write ``` References: @@ -96,6 +98,6 @@ References: - https://github.com/DietrichGebert/ponytail - https://github.com/JuliusBrussee/caveman - https://github.com/ayghri/i-have-adhd -- https://github.com/herdrdev/herdr +- https://github.com/Gaurav-Gosain/tuios - https://github.com/anthropics/skills - https://github.com/trailofbits/skills diff --git a/home/base/README.md b/home/base/README.md index 127df849..02a75055 100644 --- a/home/base/README.md +++ b/home/base/README.md @@ -42,7 +42,6 @@ systems. - **editors/**: Extra terminal editor Nix (see `core/editors/` for docs and baseline enables) - **encryption/**: Encryption and security tools - **gpg/**: GPG key management - - **herdr.nix**: Herdr agent terminal-multiplexer configuration - **password-store/**: Password management with pass - **shell/**: Shell environment configurations - **ssh.nix**: SSH configuration and management diff --git a/home/base/tui/herdr.nix b/home/base/tui/herdr.nix deleted file mode 100644 index f8a3b349..00000000 --- a/home/base/tui/herdr.nix +++ /dev/null @@ -1,42 +0,0 @@ -{ - pkgs, - lib, - llm-agents, - ... -}: -{ - programs.herdr = { - enable = true; - package = llm-agents.packages.${pkgs.stdenv.hostPlatform.system}.herdr; - - settings = { - onboarding = false; - - update = { - version_check = false; - manifest_check = false; - }; - - # home-manager owns ~/.ssh/config; keep herdr from writing it too. - remote.manage_ssh_config = false; - - # "catppuccin" is the mocha flavor, matching catppuccin-nix's fixed flavor. - theme.name = "catppuccin"; - - terminal = { - default_shell = lib.getExe pkgs.nushell; - shell_mode = "auto"; - new_cwd = "follow"; - }; - - ui = { - agent_panel_sort = "priority"; - prompt_new_tab_name = false; - sound.enabled = false; - }; - - session.resume_agents_on_restore = true; - experimental.kitty_graphics = true; - }; - }; -} diff --git a/hosts/idols-ai/preservation.nix b/hosts/idols-ai/preservation.nix index 2d11a5ed..bb112367 100644 --- a/hosts/idols-ai/preservation.nix +++ b/hosts/idols-ai/preservation.nix @@ -183,10 +183,6 @@ in ".local/share/opencode" ".local/state/opencode" - # herdr: plugin registry, plugin checkouts/config, session layout - ".config/herdr" - ".local/state/herdr" - ".context7" # up-to-date docs and code examples for for LLMs & agents # nvim