worktree command, docs/agents moved to docs/coding-agents

[leshy]

adds a ./bin/worktree cmd (totally vibed) that quickly creates a dimos worktree and installs dimos in it (pytest/mypy passes)

renames docs/agents to docs/coding-agents (there was some confusion here, these are docs for coding agents working on dimos, not docs ABOUT agents in dimos)

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ All tests successful. No failed tests found.

📢 Thoughts on this report? Let us know!

[greptile-apps]

Greptile Summary

This PR adds bin/worktree, a shell script that provisions fully-functional git worktrees (uv venv, sync, direnv, pre-commit) for parallel/agent development, and renames docs/agents/ to docs/coding-agents/ with all internal references updated.

• bin/worktree: new new/ls/rm subcommand interface; handles existing branches, remote tracking branches, and LFS skip; GNU/macOS realpath compatibility addressed with a temp-variable guard.
• flake.nix: xorg packages migrated to top-level pkgs.libx11-style names for nixpkgs-unstable; pre-commit hooks-dir logic updated to use git rev-parse --git-path hooks so the check works in linked worktrees where .git is a file, not a directory.
• docs/: directory renamed and index/links updated throughout; new worktrees.md documents the new script.

Confidence Score: 4/5

Safe to merge with one fix recommended in flake.nix's pre-commit hook check.

The hooks-dir check in flake.nix can produce a relative path in the main worktree, making pre-commit install run every time nix develop is entered from a project subdirectory — the exact failure mode the change was trying to prevent. Everything else (worktree script logic, docs rename, nixpkgs package name migration) looks correct.

flake.nix — the HOOKS_DIR relative-path issue on lines 249-250

Important Files Changed

Filename	Overview
bin/worktree	New script for creating provisioned git worktrees; GNU/BSD realpath compatibility addressed with temp-variable guard; logic looks sound for the common Linux/nix-shell workflow
flake.nix	xorg packages renamed from pkgs.xorg.libX11-style to pkgs.libx11-style for nixpkgs-unstable; pre-commit hooks-dir check updated for worktree support but uses a relative path that can resolve incorrectly when nix develop is entered from a project subdirectory
AGENTS.md	Added 'For Coding Agents' section and updated the bottom reference list; one remaining stale └── agents/ entry in the docs tree diagram was flagged in a previous review
docs/coding-agents/worktrees.md	New documentation page describing bin/worktree usage; content matches the script's actual interface
docs/coding-agents/index.md	Index updated with worktrees.md and style.md entries; internal links updated from docs/agents/ to docs/coding-agents/
bin/run-doc-codeblocks	Comment and usage text updated to reflect docs/agents/ → docs/coding-agents/ rename; no logic changes

Flowchart

%%{init: {'theme': 'neutral'}}%%
flowchart TD
    A["bin/worktree new branch [base-ref]"] --> B{Branch exists locally?}
    B -- yes --> C["git worktree add DIR BRANCH"]
    B -- no --> D{Branch exists on origin?}
    D -- yes --> E["git worktree add --track -b BRANCH DIR origin/BRANCH"]
    D -- no --> F["git worktree add -b BRANCH DIR BASE-REF"]
    C --> G["cd DIR"]
    E --> G
    F --> G
    G --> H{.envrc exists?}
    H -- no --> I["ln -s .envrc.nix OR .envrc.venv"]
    H -- yes --> J["skip symlink"]
    I --> K{envrc == .envrc.nix?}
    J --> K
    K -- yes --> L["nix develop --command bash -c uv venv + uv sync"]
    K -- no --> M["uv venv + uv sync"]
    L --> N["direnv allow ."]
    M --> N
    N --> O["ready: DIR"]

Loading

_{Reviews (7): Last reviewed commit: "fix(worktree): finish docs/agents rename..." | Re-trigger Greptile}

[Dreamsorcerer]

Don't you just do claude --worktree?

[Dreamsorcerer]

We still need to move and replace this file. This entire file will end up in the context for most coding agents.