agent-toolkit-cli 1.6.0__tar.gz → 1.8.0__tar.gz

{agent_toolkit_cli-1.6.0 → agent_toolkit_cli-1.8.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agent-toolkit-cli
-Version: 1.6.0
+Version: 1.8.0
 Summary: Composable AI agent toolkit — loops, skills, profiles, and MCP for Claude Code, Cursor, OpenCode, Windsurf, and more
 Project-URL: Homepage, https://github.com/ulises-jeremias/agent-toolkit
 Project-URL: Documentation, https://github.com/ulises-jeremias/agent-toolkit/tree/main/docs
@@ -67,7 +67,7 @@ Description-Content-Type: text/markdown
 [![License: MIT](https://img.shields.io/badge/license-MIT-7c3aed?style=flat&labelColor=1f2937)](https://github.com/ulises-jeremias/agent-toolkit/blob/main/LICENSE)
 [![Validate](https://img.shields.io/github/actions/workflow/status/ulises-jeremias/agent-toolkit/validate.yml?branch=main&label=validate&style=flat&labelColor=1f2937)](https://github.com/ulises-jeremias/agent-toolkit/actions/workflows/validate.yml)
 
-![skills](https://img.shields.io/badge/skills-52-7c3aed?style=flat&labelColor=1f2937)
+![skills](https://img.shields.io/badge/skills-61-7c3aed?style=flat&labelColor=1f2937)
 ![agents](https://img.shields.io/badge/agents-16-0891b2?style=flat&labelColor=1f2937)
 ![loops](https://img.shields.io/badge/loops-10-ea580c?style=flat&labelColor=1f2937)
 
@@ -147,7 +147,7 @@ Full walkthrough: [docs/INSTALLATION.md](https://github.com/ulises-jeremias/agen
       <h3>🛠️ Skills</h3>
       <sub>Reusable capability units (<code>SKILL.md</code>) that teach an agent how to do a job — delivery, forge CLIs, design, data, ops.</sub>
       <br><br>
-      <sub>52 skills across 9 domains. Browse with <code>agent-toolkit inventory</code> or <code>agent-toolkit skills list</code>.</sub>
+      <sub>61 skills across 9 domains. Browse with <code>agent-toolkit inventory</code> or <code>agent-toolkit skills list</code>.</sub>
     </td>
     <td width="50%" valign="top">
       <h3>🤖 Agents</h3>

{agent_toolkit_cli-1.6.0 → agent_toolkit_cli-1.8.0}/README.md

@@ -13,7 +13,7 @@
 [![License: MIT](https://img.shields.io/badge/license-MIT-7c3aed?style=flat&labelColor=1f2937)](https://github.com/ulises-jeremias/agent-toolkit/blob/main/LICENSE)
 [![Validate](https://img.shields.io/github/actions/workflow/status/ulises-jeremias/agent-toolkit/validate.yml?branch=main&label=validate&style=flat&labelColor=1f2937)](https://github.com/ulises-jeremias/agent-toolkit/actions/workflows/validate.yml)
 
-![skills](https://img.shields.io/badge/skills-52-7c3aed?style=flat&labelColor=1f2937)
+![skills](https://img.shields.io/badge/skills-61-7c3aed?style=flat&labelColor=1f2937)
 ![agents](https://img.shields.io/badge/agents-16-0891b2?style=flat&labelColor=1f2937)
 ![loops](https://img.shields.io/badge/loops-10-ea580c?style=flat&labelColor=1f2937)
 
@@ -93,7 +93,7 @@ Full walkthrough: [docs/INSTALLATION.md](https://github.com/ulises-jeremias/agen
       <h3>🛠️ Skills</h3>
       <sub>Reusable capability units (<code>SKILL.md</code>) that teach an agent how to do a job — delivery, forge CLIs, design, data, ops.</sub>
       <br><br>
-      <sub>52 skills across 9 domains. Browse with <code>agent-toolkit inventory</code> or <code>agent-toolkit skills list</code>.</sub>
+      <sub>61 skills across 9 domains. Browse with <code>agent-toolkit inventory</code> or <code>agent-toolkit skills list</code>.</sub>
     </td>
     <td width="50%" valign="top">
       <h3>🤖 Agents</h3>

{agent_toolkit_cli-1.6.0 → agent_toolkit_cli-1.8.0}/src/agent_toolkit/__init__.py

@@ -1,4 +1,4 @@
 """agent-toolkit: Composable AI agent capabilities for all major AI coding tools."""
 
-__version__ = "1.6.0"
+__version__ = "1.8.0"
 __author__ = "ulises-jeremias"

{agent_toolkit_cli-1.6.0 → agent_toolkit_cli-1.8.0}/src/agent_toolkit/cli/main.py

@@ -27,6 +27,7 @@ ADVANCED_COMMANDS: tuple[str, ...] = (
     "inventory",
     "matrix",
     "release",
+    "swarm",
 )
 
 _CONSUMER_HELP = """\
@@ -56,6 +57,7 @@ Advanced commands (workstation / power-user — docs/CLI_SURFACES.md):
     inventory     List all canonical skills, agents, and products
     matrix        Show platform capability matrix
     release       Generate release artifacts (maintainer)
+    swarm         Multi-agent swarm orchestration (pair/team/full, Herdr/tmux)
 
 Run 'agent-toolkit <command> --help' for details.
 """
@@ -150,6 +152,10 @@ def main() -> None:
             from agent_toolkit.cli.insights import cmd_insights
 
             sys.exit(cmd_insights(rest))
+        case "swarm":
+            from agent_toolkit.swarm.cli import main as swarm_main
+
+            sys.exit(swarm_main(rest))
         case _:
             print(f"Unknown command: {command}", file=sys.stderr)
             print("Run 'agent-toolkit help' for usage.", file=sys.stderr)

{agent_toolkit_cli-1.6.0 → agent_toolkit_cli-1.8.0}/src/agent_toolkit/data/catalogs/skill-catalog.yaml

@@ -1,6 +1,6 @@
 version: 1
 generated: true
-count: 52
+count: 61
 skills:
   - id: core/assistant
     name: assistant
@@ -36,6 +36,18 @@ skills:
       body using the default in references/pr-body-default.md. Pair with output-handshake
       and github-cli-workflow. Does not open th
     stability: stable
+  - id: core/project
+    name: project
+    domain: core
+    description: Clone, index, and orchestrate multi-repo work via agent-toolkit project
+      — symlinks, quick access, and swarm workspaces.
+    stability: stable
+  - id: core/workspace
+    name: workspace
+    domain: core
+    description: Scaffold and manage the stateless AI workspace — context, packs,
+      repos, and knowledge for multi-repo orchestration.
+    stability: stable
   - id: core/workspace-knowledge-sync
     name: workspace-knowledge-sync
     domain: core
@@ -284,6 +296,12 @@ skills:
     domain: forge
     description: DEPRECATED alias. Use workflow-generic-project instead.
     stability: stable
+  - id: forge/worktree
+    name: worktree
+    domain: forge
+    description: Manage Git worktrees per writer for Agent Toolkit swarms — isolated
+      branches, handoff promotion, and cleanup.
+    stability: stable
   - id: integrations/clickup-cli
     name: clickup-cli
     domain: integrations
@@ -298,6 +316,12 @@ skills:
       Use when the user wants to read, triage, create or update Linear tickets, plan
       a sprint, audit Linear documentation, or rebalance t
     stability: stable
+  - id: integrations/mcp
+    name: mcp
+    domain: integrations
+    description: Configure and manage MCP providers for Agent Toolkit — setup, list,
+      doctor, and per-tool deployment.
+    stability: stable
   - id: integrations/slack-assistant
     name: slack-assistant
     domain: integrations
@@ -332,12 +356,42 @@ skills:
       task type. Shows estimated cost per run across available providers and integrates
       with devcompanion llm-status to show what is actuall
     stability: stable
+  - id: ops/swarm
+    name: swarm
+    domain: ops
+    description: Launch an Agent Toolkit swarm from a natural language request using
+      agent-toolkit swarm CLI with Herdr/tmux eager windows and file handoffs.
+    stability: stable
+  - id: ops/swarm-handoff
+    name: swarm-handoff
+    domain: ops
+    description: Create artifact/commit file handoffs for Agent Toolkit swarms with
+      worktree-per-writer, branch, and promotion integration.
+    stability: stable
+  - id: ops/swarm-observer
+    name: swarm-observer
+    domain: ops
+    description: Observe, diagnose, and recover Agent Toolkit swarm runs via status,
+      handoffs, logs, and attach with worktree and shell awareness.
+    stability: stable
   - id: ops/triage
     name: triage
     domain: ops
     description: Workstation health triage — validate tooling, directory layout, and
       run doctor with remediation suggestions.
     stability: stable
+  - id: tooling/herdr
+    name: herdr
+    domain: tooling
+    description: Manage Herdr workspaces, tabs, and panes for Agent Toolkit swarms
+      with eager windows, shell-aware execution, and reuse.
+    stability: stable
+  - id: tooling/inventory
+    name: inventory
+    domain: tooling
+    description: Discover installed skills, agents, loops, and platform capabilities
+      via agent-toolkit inventory, matrix, and skills list.
+    stability: stable
   - id: tooling/jupyter-notebook
     name: jupyter-notebook
     domain: tooling

agent_toolkit_cli-1.8.0/src/agent_toolkit/data/catalogs/skills-layout.json

@@ -0,0 +1,391 @@
+{
+  "layout": "skills/<group>/<skill>/SKILL.md",
+  "groups": {
+    "core": [
+      "assistant",
+      "dev-companion",
+      "onboarding",
+      "output-handshake",
+      "pr-fallback",
+      "project",
+      "workspace",
+      "workspace-knowledge-sync"
+    ],
+    "data": [
+      "dbt-validation",
+      "snowflake-validation"
+    ],
+    "delivery": [
+      "adr",
+      "agreement",
+      "bug",
+      "decision-log",
+      "development-workflow",
+      "epic",
+      "incident",
+      "management-unit-assessment",
+      "meeting-minutes",
+      "planning",
+      "prd",
+      "project-assessment",
+      "project-assessment-evidence",
+      "spike",
+      "task",
+      "technical-unit-assessment",
+      "trd",
+      "user-story",
+      "work-item",
+      "workflow-client-bootstrap",
+      "workflow-generic-project"
+    ],
+    "design": [
+      "figma",
+      "figma-code-connect-components",
+      "figma-create-design-system-rules",
+      "figma-create-new-file",
+      "figma-implement-design",
+      "ui-ux-pro-max"
+    ],
+    "forge": [
+      "gh-address-comments",
+      "gh-contribution-planner",
+      "gh-fix-ci",
+      "github-cli-workflow",
+      "gitlab-cli-workflow",
+      "workflow-client-bootstrap",
+      "workflow-generic-project",
+      "worktree"
+    ],
+    "integrations": [
+      "clickup-cli",
+      "linear",
+      "mcp",
+      "slack-assistant",
+      "slack-cli"
+    ],
+    "loops": [
+      "loop-runner"
+    ],
+    "ops": [
+      "docs-generator",
+      "llm-cost-advisor",
+      "swarm",
+      "swarm-handoff",
+      "swarm-observer",
+      "triage"
+    ],
+    "tooling": [
+      "herdr",
+      "inventory",
+      "jupyter-notebook",
+      "playwright-cli"
+    ]
+  },
+  "skills": [
+    {
+      "id": "core/assistant",
+      "name": "assistant",
+      "domain": "core"
+    },
+    {
+      "id": "core/dev-companion",
+      "name": "dev-companion",
+      "domain": "core"
+    },
+    {
+      "id": "core/onboarding",
+      "name": "onboarding",
+      "domain": "core"
+    },
+    {
+      "id": "core/output-handshake",
+      "name": "output-handshake",
+      "domain": "core"
+    },
+    {
+      "id": "core/pr-fallback",
+      "name": "pr-fallback",
+      "domain": "core"
+    },
+    {
+      "id": "core/project",
+      "name": "project",
+      "domain": "core"
+    },
+    {
+      "id": "core/workspace",
+      "name": "workspace",
+      "domain": "core"
+    },
+    {
+      "id": "core/workspace-knowledge-sync",
+      "name": "workspace-knowledge-sync",
+      "domain": "core"
+    },
+    {
+      "id": "data/dbt-validation",
+      "name": "dbt-validation",
+      "domain": "data"
+    },
+    {
+      "id": "data/snowflake-validation",
+      "name": "snowflake-validation",
+      "domain": "data"
+    },
+    {
+      "id": "delivery/adr",
+      "name": "adr",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/agreement",
+      "name": "agreement",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/bug",
+      "name": "bug",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/decision-log",
+      "name": "decision-log",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/development-workflow",
+      "name": "development-workflow",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/epic",
+      "name": "epic",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/incident",
+      "name": "incident",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/management-unit-assessment",
+      "name": "management-unit-assessment",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/meeting-minutes",
+      "name": "meeting-minutes",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/planning",
+      "name": "planning",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/prd",
+      "name": "prd",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/project-assessment",
+      "name": "project-assessment",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/project-assessment-evidence",
+      "name": "project-assessment-evidence",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/spike",
+      "name": "spike",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/task",
+      "name": "task",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/technical-unit-assessment",
+      "name": "technical-unit-assessment",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/trd",
+      "name": "trd",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/user-story",
+      "name": "user-story",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/work-item",
+      "name": "work-item",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/workflow-client-bootstrap",
+      "name": "workflow-client-bootstrap",
+      "domain": "delivery"
+    },
+    {
+      "id": "delivery/workflow-generic-project",
+      "name": "workflow-generic-project",
+      "domain": "delivery"
+    },
+    {
+      "id": "design/figma",
+      "name": "figma",
+      "domain": "design"
+    },
+    {
+      "id": "design/figma-code-connect-components",
+      "name": "figma-code-connect-components",
+      "domain": "design"
+    },
+    {
+      "id": "design/figma-create-design-system-rules",
+      "name": "figma-create-design-system-rules",
+      "domain": "design"
+    },
+    {
+      "id": "design/figma-create-new-file",
+      "name": "figma-create-new-file",
+      "domain": "design"
+    },
+    {
+      "id": "design/figma-implement-design",
+      "name": "figma-implement-design",
+      "domain": "design"
+    },
+    {
+      "id": "design/ui-ux-pro-max",
+      "name": "ui-ux-pro-max",
+      "domain": "design"
+    },
+    {
+      "id": "forge/gh-address-comments",
+      "name": "gh-address-comments",
+      "domain": "forge"
+    },
+    {
+      "id": "forge/gh-contribution-planner",
+      "name": "gh-contribution-planner",
+      "domain": "forge"
+    },
+    {
+      "id": "forge/gh-fix-ci",
+      "name": "gh-fix-ci",
+      "domain": "forge"
+    },
+    {
+      "id": "forge/github-cli-workflow",
+      "name": "github-cli-workflow",
+      "domain": "forge"
+    },
+    {
+      "id": "forge/gitlab-cli-workflow",
+      "name": "gitlab-cli-workflow",
+      "domain": "forge"
+    },
+    {
+      "id": "forge/workflow-client-bootstrap",
+      "name": "workflow-client-bootstrap",
+      "domain": "forge"
+    },
+    {
+      "id": "forge/workflow-generic-project",
+      "name": "workflow-generic-project",
+      "domain": "forge"
+    },
+    {
+      "id": "forge/worktree",
+      "name": "worktree",
+      "domain": "forge"
+    },
+    {
+      "id": "integrations/clickup-cli",
+      "name": "clickup-cli",
+      "domain": "integrations"
+    },
+    {
+      "id": "integrations/linear",
+      "name": "linear",
+      "domain": "integrations"
+    },
+    {
+      "id": "integrations/mcp",
+      "name": "mcp",
+      "domain": "integrations"
+    },
+    {
+      "id": "integrations/slack-assistant",
+      "name": "slack-assistant",
+      "domain": "integrations"
+    },
+    {
+      "id": "integrations/slack-cli",
+      "name": "slack-cli",
+      "domain": "integrations"
+    },
+    {
+      "id": "loops/loop-runner",
+      "name": "loop-runner",
+      "domain": "loops"
+    },
+    {
+      "id": "ops/docs-generator",
+      "name": "docs-generator",
+      "domain": "ops"
+    },
+    {
+      "id": "ops/llm-cost-advisor",
+      "name": "llm-cost-advisor",
+      "domain": "ops"
+    },
+    {
+      "id": "ops/swarm",
+      "name": "swarm",
+      "domain": "ops"
+    },
+    {
+      "id": "ops/swarm-handoff",
+      "name": "swarm-handoff",
+      "domain": "ops"
+    },
+    {
+      "id": "ops/swarm-observer",
+      "name": "swarm-observer",
+      "domain": "ops"
+    },
+    {
+      "id": "ops/triage",
+      "name": "triage",
+      "domain": "ops"
+    },
+    {
+      "id": "tooling/herdr",
+      "name": "herdr",
+      "domain": "tooling"
+    },
+    {
+      "id": "tooling/inventory",
+      "name": "inventory",
+      "domain": "tooling"
+    },
+    {
+      "id": "tooling/jupyter-notebook",
+      "name": "jupyter-notebook",
+      "domain": "tooling"
+    },
+    {
+      "id": "tooling/playwright-cli",
+      "name": "playwright-cli",
+      "domain": "tooling"
+    }
+  ]
+}

{agent_toolkit_cli-1.6.0 → agent_toolkit_cli-1.8.0}/src/agent_toolkit/data/distributions/products.yaml

@@ -153,9 +153,18 @@ products:
         - loops/loop-runner
         - ops/docs-generator
         - ops/llm-cost-advisor
+        - ops/swarm
+        - ops/swarm-handoff
+        - ops/swarm-observer
         - ops/triage
+        - tooling/herdr
+        - tooling/inventory
         - tooling/jupyter-notebook
         - tooling/playwright-cli
+        - core/project
+        - core/workspace
+        - forge/worktree
+        - integrations/mcp
       agents: []
       hooks: []
       mcp: []

agent_toolkit_cli-1.8.0/src/agent_toolkit/data/skills/core/project/SKILL.md

@@ -0,0 +1,83 @@
+---
+name: project
+description: Clone, index, and orchestrate multi-repo work via agent-toolkit project — symlinks, quick access, and swarm workspaces.
+metadata:
+  author: ulises-jeremias
+  version: "1.0"
+  tags: [project, git, multi-repo, workspace]
+---
+
+# Project
+
+Manage the local multi-repo registry (`~/.ai-workspace/repos/` and `projects/` symlinks) so swarms and agents can target any repo by name, not path.
+
+## When to use
+
+- User says "clone X", "add repo Y", "list projects", or references `owner/repo` without a local path.
+- Swarm needs `--workspace /path/to/repo` that isn't yet cloned.
+- Workspace context shows missing `projects/` symlink for a repo referenced in a prompt.
+
+## Prerequisites
+
+- `agent-toolkit` with `project` subcommand (`agent-toolkit project --help`).
+- `gh` authenticated for private repos (`gh auth status`).
+- Workspace has `repos/github.com/<owner>/<repo>` layout.
+
+## Workflow
+
+### 1. Clone and index
+
+```bash
+agent-toolkit project clone owner/my-repo          # clone + symlink projects/my-repo -> repos/github.com/owner/my-repo
+agent-toolkit project clone owner/my-repo --branch feat/x
+# Alias resolution: swarm's config.py also resolves_owner_repo from prompt URLs like https://github.com/owner/repo
+
+# Verify
+agent-toolkit project list                         # indexed projects
+ls -l ~/.ai-workspace/projects
+ls ~/.ai-workspace/repos/github.com/owner/my-repo
+```
+
+### 2. Use with swarm and other skills
+
+```bash
+# Swarm can target any indexed repo via --workspace
+agent-toolkit swarm start --recipe pair --ui herdr --runner opencode --model-profile balanced --workspace ~/.ai-workspace/repos/github.com/owner/my-repo --attach "task"
+# Inside a cloned repo, just run from its directory — swarm's find_repo_root uses git rev-parse --git-common-dir
+
+# Assistant discovery before swarm
+# (assistant skill: README -> docs/ -> AGENTS.md -> CONTRIBUTING -> PR templates -> Makefile/package.json -> devcontainer -> CI -> configs)
+```
+
+### 3. Scan and sync
+
+```bash
+agent-toolkit project scan                         # re-index repos/ -> projects/
+agent-toolkit project list --json | jq
+agent-toolkit workspace context --json | jq '.repos'
+```
+
+### 4. Multi-repo swarms
+
+For cross-repo tasks, clone all targets first, then launch swarms per repo with handoffs referencing the correct `--workspace` or `AGENT_TOOLKIT_SWARM_REPO` env:
+
+```bash
+agent-toolkit project clone org/repo-a
+agent-toolkit project clone org/repo-b
+export AGENT_TOOLKIT_SWARM_REPO=org/repo-a  # swarm's store respects this for run location
+```
+
+## Boundaries
+
+- Never `git clone` by hand when `project clone` can do it — it handles symlinks and registry.
+- Never assume CWD is the target repo; use `--workspace` or `workdir` per `AGENTS.md`.
+- Do not delete `repos/` entries directly; use `agent-toolkit project remove` if available, or ask before manual `rm`.
+
+## Delegates to
+
+| Need | Skill |
+|------|-------|
+| Workspace packs and memory for the new repo | `workspace` |
+| Repo conventions before coding | `assistant` |
+| Swarm orchestration on the repo | `swarm` |
+| Branch/PR after swarm promotion | `github-cli-workflow` |