agentkit-cli 0.1.0__tar.gz

agentkit_cli-0.1.0/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+## v0.1.0 (2026-03-12)
+
+Initial release.
+
+### Added
+- `agentkit init` — initialize project, detect tools, create `.agentkit.yaml`
+- `agentkit run` — sequential pipeline runner (generate → lint → benchmark → reflect)
+- `agentkit status` — health check with tool versions and last run summary
+- `--json` flag on `run` and `status` for machine-readable output
+- `--skip` flag on `run` to skip individual steps
+- `--benchmark` flag to opt-in to the coderace benchmark step
+- Rich terminal output throughout
+- 25+ tests with typer CliRunner

agentkit_cli-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 mikiships
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

agentkit_cli-0.1.0/PKG-INFO

@@ -0,0 +1,148 @@
+Metadata-Version: 2.4
+Name: agentkit-cli
+Version: 0.1.0
+Summary: Unified CLI for the Agent Quality Toolkit (agentmd, coderace, agentlint, agentreflect)
+Project-URL: Homepage, https://github.com/mikiships/agentkit-cli
+Project-URL: Repository, https://github.com/mikiships/agentkit-cli
+Project-URL: Changelog, https://github.com/mikiships/agentkit-cli/blob/main/CHANGELOG.md
+Author-email: mikiships <frank.michaels2123@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: agents,ai,benchmark,cli,llm,quality,toolkit
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Quality Assurance
+Classifier: Topic :: Software Development :: Testing
+Requires-Python: >=3.11
+Requires-Dist: rich>=13.0.0
+Requires-Dist: typer>=0.9.0
+Description-Content-Type: text/markdown
+
+# agentkit-cli
+
+**One install to rule them all.**
+
+```bash
+pip install agentkit-cli
+```
+
+Get the full Agent Quality Toolkit pipeline in a single command — no more juggling four separate `pip install` steps.
+
+---
+
+## What is it?
+
+`agentkit-cli` is a unified meta-CLI that wraps the **Agent Quality Toolkit quartet**:
+
+| Tool | Purpose |
+|------|---------|
+| [agentmd](https://pypi.org/project/agentmd/) | Generate CLAUDE.md context files |
+| [agentlint](https://pypi.org/project/agentlint/) | Lint AI context files and git diffs |
+| [coderace](https://pypi.org/project/coderace/) | Benchmark AI coding performance |
+| [agentreflect](https://pypi.org/project/agentreflect/) | Generate reflection reports from failures |
+
+## Pipeline Overview
+
+```
+agentkit run
+    │
+    ├── 1. agentmd generate        → produces CLAUDE.md
+    ├── 2. agentlint check-context → lints CLAUDE.md
+    ├── 3. agentlint (diff)        → lints recent changes
+    ├── 4. coderace benchmark      → (opt-in via --benchmark)
+    └── 5. agentreflect generate   → reflection on failures
+```
+
+Zero to full pipeline in 30 seconds.
+
+---
+
+## Installation
+
+```bash
+pip install agentkit-cli
+```
+
+Install the quartet tools too:
+
+```bash
+pip install agentmd agentlint coderace agentreflect
+```
+
+---
+
+## Usage
+
+### `agentkit init`
+
+Initialize agentkit in a project. Checks which tools are installed and creates `.agentkit.yaml`.
+
+```bash
+agentkit init
+agentkit init --path /my/project
+```
+
+Creates `.agentkit.yaml`:
+
+```yaml
+tools:
+  coderace: true
+  agentmd: true
+  agentlint: true
+  agentreflect: true
+defaults:
+  min_score: 80
+  context_file: CLAUDE.md
+```
+
+---
+
+### `agentkit run`
+
+Run the full quality pipeline sequentially.
+
+```bash
+agentkit run
+agentkit run --path /my/project
+agentkit run --skip generate
+agentkit run --skip lint
+agentkit run --skip benchmark
+agentkit run --skip reflect
+agentkit run --benchmark        # include benchmark step
+agentkit run --json             # emit summary as JSON
+agentkit run --notes "regression after refactor"
+```
+
+Missing tools are skipped automatically with a warning — you don't need all four installed.
+
+---
+
+### `agentkit status`
+
+Quick health check: tool versions, config presence, last run summary.
+
+```bash
+agentkit status
+agentkit status --path /my/project
+agentkit status --json
+```
+
+---
+
+## Links
+
+- [agentmd](https://pypi.org/project/agentmd/)
+- [agentlint](https://pypi.org/project/agentlint/)
+- [coderace](https://pypi.org/project/coderace/)
+- [agentreflect](https://pypi.org/project/agentreflect/)
+
+---
+
+## License
+
+MIT

agentkit_cli-0.1.0/README.md

@@ -0,0 +1,123 @@
+# agentkit-cli
+
+**One install to rule them all.**
+
+```bash
+pip install agentkit-cli
+```
+
+Get the full Agent Quality Toolkit pipeline in a single command — no more juggling four separate `pip install` steps.
+
+---
+
+## What is it?
+
+`agentkit-cli` is a unified meta-CLI that wraps the **Agent Quality Toolkit quartet**:
+
+| Tool | Purpose |
+|------|---------|
+| [agentmd](https://pypi.org/project/agentmd/) | Generate CLAUDE.md context files |
+| [agentlint](https://pypi.org/project/agentlint/) | Lint AI context files and git diffs |
+| [coderace](https://pypi.org/project/coderace/) | Benchmark AI coding performance |
+| [agentreflect](https://pypi.org/project/agentreflect/) | Generate reflection reports from failures |
+
+## Pipeline Overview
+
+```
+agentkit run
+    │
+    ├── 1. agentmd generate        → produces CLAUDE.md
+    ├── 2. agentlint check-context → lints CLAUDE.md
+    ├── 3. agentlint (diff)        → lints recent changes
+    ├── 4. coderace benchmark      → (opt-in via --benchmark)
+    └── 5. agentreflect generate   → reflection on failures
+```
+
+Zero to full pipeline in 30 seconds.
+
+---
+
+## Installation
+
+```bash
+pip install agentkit-cli
+```
+
+Install the quartet tools too:
+
+```bash
+pip install agentmd agentlint coderace agentreflect
+```
+
+---
+
+## Usage
+
+### `agentkit init`
+
+Initialize agentkit in a project. Checks which tools are installed and creates `.agentkit.yaml`.
+
+```bash
+agentkit init
+agentkit init --path /my/project
+```
+
+Creates `.agentkit.yaml`:
+
+```yaml
+tools:
+  coderace: true
+  agentmd: true
+  agentlint: true
+  agentreflect: true
+defaults:
+  min_score: 80
+  context_file: CLAUDE.md
+```
+
+---
+
+### `agentkit run`
+
+Run the full quality pipeline sequentially.
+
+```bash
+agentkit run
+agentkit run --path /my/project
+agentkit run --skip generate
+agentkit run --skip lint
+agentkit run --skip benchmark
+agentkit run --skip reflect
+agentkit run --benchmark        # include benchmark step
+agentkit run --json             # emit summary as JSON
+agentkit run --notes "regression after refactor"
+```
+
+Missing tools are skipped automatically with a warning — you don't need all four installed.
+
+---
+
+### `agentkit status`
+
+Quick health check: tool versions, config presence, last run summary.
+
+```bash
+agentkit status
+agentkit status --path /my/project
+agentkit status --json
+```
+
+---
+
+## Links
+
+- [agentmd](https://pypi.org/project/agentmd/)
+- [agentlint](https://pypi.org/project/agentlint/)
+- [coderace](https://pypi.org/project/coderace/)
+- [agentreflect](https://pypi.org/project/agentreflect/)
+
+---
+
+## License
+
+MIT

agentkit_cli-0.1.0/agentkit_cli/__init__.py

@@ -0,0 +1,3 @@
+"""agentkit-cli: Unified CLI for the Agent Quality Toolkit."""
+
+__version__ = "0.1.0"

agentkit_cli-0.1.0/agentkit_cli/commands/__init__.py

@@ -0,0 +1 @@
+# commands package

agentkit_cli-0.1.0/agentkit_cli/commands/init_cmd.py

@@ -0,0 +1,63 @@
+"""agentkit init command."""
+from __future__ import annotations
+
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.panel import Panel
+from rich.table import Table
+from rich import print as rprint
+
+from agentkit_cli.tools import QUARTET_TOOLS, is_installed, INSTALL_HINTS
+from agentkit_cli.config import find_project_root, config_path, config_exists, write_default_config
+
+console = Console()
+
+
+def init_command(
+    path: Optional[Path] = typer.Option(None, "--path", "-p", help="Project root (default: git root or cwd)"),
+) -> None:
+    """Initialize agentkit in a project directory."""
+    root = path or find_project_root()
+    console.print(f"\n[bold]Initializing agentkit in:[/bold] {root}\n")
+
+    # Check quartet tools
+    table = Table(title="Agent Quality Toolkit — Tool Status", show_header=True)
+    table.add_column("Tool", style="bold")
+    table.add_column("Status")
+    table.add_column("Install Command")
+
+    missing = []
+    for tool in QUARTET_TOOLS:
+        if is_installed(tool):
+            table.add_row(tool, "[green]✓ installed[/green]", "")
+        else:
+            table.add_row(tool, "[red]✗ missing[/red]", INSTALL_HINTS.get(tool, f"pip install {tool}"))
+            missing.append(tool)
+
+    console.print(table)
+
+    # Write config
+    cfg_path = config_path(root)
+    if config_exists(root):
+        console.print(f"\n[yellow]Config already exists:[/yellow] {cfg_path}")
+    else:
+        written = write_default_config(root)
+        console.print(f"\n[green]Created config:[/green] {written}")
+
+    # Print install instructions for missing tools
+    if missing:
+        console.print("\n[yellow]Install missing tools:[/yellow]")
+        for tool in missing:
+            console.print(f"  pip install {tool}")
+
+    # Next steps
+    next_steps = "\n".join([
+        "1. Install any missing tools (see above)",
+        "2. Run [bold]agentkit run[/bold] to execute the full quality pipeline",
+        "3. Run [bold]agentkit status[/bold] to check your setup at any time",
+    ])
+    console.print(Panel(next_steps, title="Next Steps", border_style="blue"))
+    console.print()

agentkit_cli-0.1.0/agentkit_cli/commands/run_cmd.py

@@ -0,0 +1,173 @@
+"""agentkit run command — sequential pipeline runner."""
+from __future__ import annotations
+
+import json
+import time
+from datetime import datetime, timezone
+from pathlib import Path
+from typing import List, Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from agentkit_cli.tools import is_installed, run_tool, INSTALL_HINTS
+from agentkit_cli.config import find_project_root, save_last_run
+
+console = Console()
+
+STEP_TOOL_MAP = {
+    "generate": "agentmd",
+    "lint": "agentlint",
+    "benchmark": "coderace",
+    "reflect": "agentreflect",
+}
+
+
+def _run_step(name: str, tool: str, args: list[str], cwd: str) -> dict:
+    """Execute one pipeline step; return result dict."""
+    start = time.monotonic()
+    if not is_installed(tool):
+        return {
+            "step": name,
+            "tool": tool,
+            "status": "skipped",
+            "reason": f"not installed — {INSTALL_HINTS.get(tool, f'pip install {tool}')}",
+            "duration": 0.0,
+            "output": "",
+        }
+    try:
+        result = run_tool(tool, args, cwd=cwd)
+        duration = time.monotonic() - start
+        success = result.returncode == 0
+        return {
+            "step": name,
+            "tool": tool,
+            "status": "pass" if success else "fail",
+            "returncode": result.returncode,
+            "duration": round(duration, 2),
+            "output": (result.stdout + result.stderr).strip(),
+        }
+    except Exception as e:
+        return {
+            "step": name,
+            "tool": tool,
+            "status": "error",
+            "reason": str(e),
+            "duration": round(time.monotonic() - start, 2),
+            "output": "",
+        }
+
+
+def run_command(
+    path: Optional[Path] = typer.Option(None, "--path", "-p", help="Project directory to run against"),
+    skip: Optional[List[str]] = typer.Option(None, "--skip", help="Steps to skip: generate, lint, benchmark, reflect"),
+    benchmark: bool = typer.Option(False, "--benchmark", help="Include benchmark step (skipped by default)"),
+    json_output: bool = typer.Option(False, "--json", help="Output summary JSON"),
+    notes: Optional[str] = typer.Option(None, "--notes", help="Notes passed to agentreflect"),
+) -> None:
+    """Run the full Agent Quality pipeline."""
+    root = path or find_project_root()
+    cwd_str = str(root)
+    skip_set = set(s.lower() for s in (skip or []))
+
+    # Benchmark is opt-in
+    if not benchmark:
+        skip_set.add("benchmark")
+
+    console.print(f"\n[bold]agentkit run[/bold] — project: {root}\n")
+
+    context_file = root / "CLAUDE.md"
+    results = []
+
+    # Step 1: generate
+    if "generate" not in skip_set:
+        console.print("[dim]→ agentmd generate ...[/dim]")
+        r = _run_step("generate", "agentmd", ["generate", cwd_str], cwd_str)
+        results.append(r)
+    else:
+        results.append({"step": "generate", "tool": "agentmd", "status": "skipped", "reason": "user skipped", "duration": 0.0})
+
+    # Step 2: lint context file
+    if "lint" not in skip_set:
+        lint_args = ["check-context", str(context_file)] if context_file.exists() else ["check-context", cwd_str]
+        console.print("[dim]→ agentlint check-context ...[/dim]")
+        r = _run_step("lint-context", "agentlint", lint_args, cwd_str)
+        results.append(r)
+
+        # Step 3: lint diffs
+        console.print("[dim]→ agentlint (diff) ...[/dim]")
+        r2 = _run_step("lint-diff", "agentlint", [cwd_str], cwd_str)
+        results.append(r2)
+    else:
+        results.append({"step": "lint-context", "tool": "agentlint", "status": "skipped", "reason": "user skipped", "duration": 0.0})
+        results.append({"step": "lint-diff", "tool": "agentlint", "status": "skipped", "reason": "user skipped", "duration": 0.0})
+
+    # Step 4: benchmark (opt-in)
+    if "benchmark" not in skip_set:
+        console.print("[dim]→ coderace benchmark ...[/dim]")
+        r = _run_step("benchmark", "coderace", ["benchmark", cwd_str], cwd_str)
+        results.append(r)
+    else:
+        results.append({"step": "benchmark", "tool": "coderace", "status": "skipped", "reason": "opt-in only (use --benchmark)", "duration": 0.0})
+
+    # Step 5: reflect
+    if "reflect" not in skip_set:
+        reflect_args = ["generate", "--notes", notes or "agentkit run completed", cwd_str]
+        console.print("[dim]→ agentreflect generate ...[/dim]")
+        r = _run_step("reflect", "agentreflect", reflect_args, cwd_str)
+        results.append(r)
+    else:
+        results.append({"step": "reflect", "tool": "agentreflect", "status": "skipped", "reason": "user skipped", "duration": 0.0})
+
+    # Display table
+    table = Table(title="Pipeline Results", show_header=True)
+    table.add_column("Step", style="bold")
+    table.add_column("Tool")
+    table.add_column("Status")
+    table.add_column("Duration")
+    table.add_column("Notes", max_width=50)
+
+    status_colors = {"pass": "green", "fail": "red", "skipped": "yellow", "error": "red"}
+
+    for r in results:
+        status = r.get("status", "unknown")
+        color = status_colors.get(status, "white")
+        duration = f"{r.get('duration', 0):.2f}s" if r.get("duration") else ""
+        note = r.get("reason", "") or (r.get("output", "")[:60] if r.get("output") else "")
+        table.add_row(
+            r["step"],
+            r.get("tool", ""),
+            f"[{color}]{status}[/{color}]",
+            duration,
+            note,
+        )
+
+    console.print()
+    console.print(table)
+
+    # Save last run
+    summary = {
+        "timestamp": datetime.now(timezone.utc).isoformat(),
+        "project": cwd_str,
+        "steps": results,
+        "total": len(results),
+        "passed": sum(1 for r in results if r.get("status") == "pass"),
+        "failed": sum(1 for r in results if r.get("status") == "fail"),
+        "skipped": sum(1 for r in results if r.get("status") == "skipped"),
+    }
+    try:
+        save_last_run(summary, root)
+    except Exception:
+        pass
+
+    if json_output:
+        console.print("\n[bold]JSON Output:[/bold]")
+        print(json.dumps(summary, indent=2))
+
+    # Final status
+    if summary["failed"] > 0:
+        console.print(f"\n[red]Pipeline completed with {summary['failed']} failure(s).[/red]")
+        raise typer.Exit(code=1)
+    else:
+        console.print(f"\n[green]Pipeline complete.[/green] {summary['passed']} passed, {summary['skipped']} skipped.\n")

agentkit_cli-0.1.0/agentkit_cli/commands/status_cmd.py

@@ -0,0 +1,97 @@
+"""agentkit status command."""
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Optional
+
+import typer
+from rich.console import Console
+from rich.table import Table
+
+from agentkit_cli.tools import tool_status
+from agentkit_cli.config import find_project_root, config_exists, load_last_run
+
+console = Console()
+
+
+def status_command(
+    path: Optional[Path] = typer.Option(None, "--path", "-p", help="Project directory to check"),
+    json_output: bool = typer.Option(False, "--json", help="Output as JSON"),
+) -> None:
+    """Show health status of the Agent Quality Toolkit."""
+    root = path or find_project_root()
+    console.print(f"\n[bold]agentkit status[/bold] — project: {root}\n")
+
+    # Tool table
+    tool_table = Table(title="Quartet Tools", show_header=True)
+    tool_table.add_column("Tool", style="bold")
+    tool_table.add_column("Status")
+    tool_table.add_column("Version")
+    tool_table.add_column("Path")
+
+    ts = tool_status()
+    for tool, info in ts.items():
+        if info["installed"]:
+            status_str = "[green]✓ installed[/green]"
+            version_str = info.get("version") or "—"
+            path_str = info.get("path") or "—"
+        else:
+            status_str = "[red]✗ missing[/red]"
+            version_str = "—"
+            path_str = "—"
+        tool_table.add_row(tool, status_str, version_str, path_str)
+
+    console.print(tool_table)
+
+    # Project files table
+    files_table = Table(title="Project Files", show_header=True)
+    files_table.add_column("File", style="bold")
+    files_table.add_column("Status")
+
+    config_ok = config_exists(root)
+    claude_ok = (root / "CLAUDE.md").exists()
+    last_run_ok = (root / ".agentkit-last-run.json").exists()
+
+    files_table.add_row(
+        ".agentkit.yaml",
+        "[green]✓ exists[/green]" if config_ok else "[yellow]✗ missing — run agentkit init[/yellow]",
+    )
+    files_table.add_row(
+        "CLAUDE.md",
+        "[green]✓ exists[/green]" if claude_ok else "[yellow]✗ missing[/yellow]",
+    )
+    files_table.add_row(
+        ".agentkit-last-run.json",
+        "[green]✓ exists[/green]" if last_run_ok else "[dim]not found[/dim]",
+    )
+
+    console.print(files_table)
+
+    # Last run summary
+    last_run = load_last_run(root)
+    if last_run:
+        lr_table = Table(title="Last Run Summary", show_header=True)
+        lr_table.add_column("Key", style="bold")
+        lr_table.add_column("Value")
+        lr_table.add_row("Timestamp", last_run.get("timestamp", "—"))
+        lr_table.add_row("Passed", str(last_run.get("passed", "—")))
+        lr_table.add_row("Failed", str(last_run.get("failed", "—")))
+        lr_table.add_row("Skipped", str(last_run.get("skipped", "—")))
+        console.print(lr_table)
+
+    if json_output:
+        output = {
+            "project": str(root),
+            "tools": ts,
+            "files": {
+                ".agentkit.yaml": config_ok,
+                "CLAUDE.md": claude_ok,
+                ".agentkit-last-run.json": last_run_ok,
+            },
+            "last_run": last_run,
+        }
+        console.print("\n[bold]JSON Output:[/bold]")
+        print(json.dumps(output, indent=2))
+
+    console.print()