overcode 0.2.0__tar.gz → 0.2.2__tar.gz

{overcode-0.2.0/src/overcode.egg-info → overcode-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: overcode
-Version: 0.2.0
+Version: 0.2.2
 Summary: A supervisor for managing multiple Claude Code instances in tmux
 Author: Mike Bond
 Project-URL: Homepage, https://github.com/mkb23/overcode

{overcode-0.2.0 → overcode-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "overcode"
-version = "0.2.0"
+version = "0.2.2"
 description = "A supervisor for managing multiple Claude Code instances in tmux"
 authors = [
     {name = "Mike Bond"}
@@ -68,7 +68,7 @@ tui-eye = "overcode.testing.tui_eye:main"
 where = ["src"]
 
 [tool.setuptools.package-data]
-overcode = ["*.md", "*.sh", "*.tcss"]
+overcode = ["*.md", "*.sh", "*.tcss", "web/templates/*.html"]
 
 [tool.black]
 line-length = 100

{overcode-0.2.0 → overcode-0.2.2}/src/overcode/bundled_skills.py

@@ -5,6 +5,8 @@ Skills are installed as directories with a SKILL.md entry point, following
 the Claude Code skill format. Each skill has a description and content field.
 """
 
+from pathlib import Path
+
 # Skill names that were renamed — installer removes these on install
 DEPRECATED_SKILL_NAMES = ["delegation"]
 
@@ -28,6 +30,8 @@ Overcode manages multiple Claude Code agent sessions in tmux.
 # Launch
 overcode launch -n <name> [-d <path>] [-p "<prompt>"] [--follow] [--bypass-permissions]
 overcode launch -n <name> --follow --oversight-timeout 5m -p "... When done: overcode report --status success"
+overcode launch -n <name> --allowed-tools "Read,Glob,Grep" --skip-permissions
+overcode launch -n <name> --claude-arg "--model haiku" --claude-arg "--effort low"
 
 # Monitor
 overcode list [name] [--show-done]
@@ -165,6 +169,26 @@ overcode budget set child-agent 3.00                  # Set directly
 
 Exceeded budget = heartbeats and supervisor stop, agent winds down naturally.
 
+## Tool Restrictions
+
+Scope agent capabilities with `--allowed-tools` for safety:
+
+```bash
+# Read-only agent — cannot modify files
+overcode launch -n safe-reader --follow --allowed-tools "Read,Glob,Grep" \\
+  -p "Analyze the codebase. Do NOT modify files. When done: overcode report --status success"
+
+# Code-only agent — no shell access
+overcode launch -n coder --follow --allowed-tools "Read,Write,Edit,Glob,Grep" --skip-permissions \\
+  -p "Refactor auth module. When done: overcode report --status success"
+```
+
+Pass arbitrary Claude CLI flags with `--claude-arg` (repeatable):
+
+```bash
+overcode launch -n fast --claude-arg "--model haiku" --claude-arg "--effort low" -p "Quick review"
+```
+
 ## Rules
 
 - Parent auto-detected from `OVERCODE_SESSION_NAME` \u2014 no `--parent` needed inside an overcode agent
@@ -173,3 +197,13 @@ Exceeded budget = heartbeats and supervisor stop, agent winds down naturally.
 """,
     },
 }
+
+
+def any_skills_stale() -> bool:
+    """Check if any installed skills are outdated vs bundled versions."""
+    base = Path.home() / ".claude" / "skills"
+    for name, skill in OVERCODE_SKILLS.items():
+        skill_file = base / name / "SKILL.md"
+        if skill_file.exists() and skill_file.read_text() != skill["content"]:
+            return True
+    return False

overcode-0.2.2/src/overcode/cli/__init__.py

@@ -0,0 +1,32 @@
+"""
+CLI interface for Overcode using Typer.
+
+This package was split from a single cli.py module. All public names
+are re-exported here for backward compatibility.
+"""
+
+# Import shared state (apps, options, utilities) — must come first
+from ._shared import app, main_callback, _parse_duration, SessionOption  # noqa: F401
+
+# Re-export for backward compat (tests patch overcode.cli.ClaudeLauncher)
+from ..launcher import ClaudeLauncher  # noqa: F401
+
+# Import submodules to register their commands with the Typer apps
+from . import agent  # noqa: F401
+from . import budget  # noqa: F401
+from . import hooks  # noqa: F401
+from . import skills  # noqa: F401
+from . import perms  # noqa: F401
+from . import monitoring  # noqa: F401
+from . import daemon  # noqa: F401
+from . import sister  # noqa: F401
+from . import config  # noqa: F401
+
+
+def main():
+    """Main entry point for the CLI."""
+    app()
+
+
+if __name__ == "__main__":
+    main()

overcode-0.2.2/src/overcode/cli/__main__.py

@@ -0,0 +1,5 @@
+"""Allow running the CLI as ``python -m overcode.cli``."""
+
+from . import main
+
+main()

overcode-0.2.2/src/overcode/cli/_shared.py

@@ -0,0 +1,121 @@
+"""
+Shared CLI state: Typer apps, console, options, and utilities.
+"""
+
+from typing import Annotated
+
+import typer
+from rich.console import Console
+
+# Main app
+app = typer.Typer(
+    name="overcode",
+    help="Manage and supervise Claude Code agents",
+    no_args_is_help=False,
+    invoke_without_command=True,
+    rich_markup_mode="rich",
+)
+
+
+# Monitor daemon subcommand group
+monitor_daemon_app = typer.Typer(
+    name="monitor-daemon",
+    help="Manage the Monitor Daemon (metrics/state tracking)",
+    no_args_is_help=False,
+    invoke_without_command=True,
+)
+app.add_typer(monitor_daemon_app, name="monitor-daemon")
+
+# Supervisor daemon subcommand group
+supervisor_daemon_app = typer.Typer(
+    name="supervisor-daemon",
+    help="Manage the Supervisor Daemon (Claude orchestration)",
+    no_args_is_help=False,
+    invoke_without_command=True,
+)
+app.add_typer(supervisor_daemon_app, name="supervisor-daemon")
+
+# Hooks subcommand group
+hooks_app = typer.Typer(
+    name="hooks",
+    help="Manage Claude Code hook integration.",
+    no_args_is_help=True,
+)
+app.add_typer(hooks_app, name="hooks")
+
+# Skills subcommand group
+skills_app = typer.Typer(
+    name="skills",
+    help="Manage Claude Code skill files.",
+    no_args_is_help=True,
+)
+app.add_typer(skills_app, name="skills")
+
+# Perms subcommand group
+perms_app = typer.Typer(
+    name="perms",
+    help="Manage Claude Code tool permissions for overcode commands.",
+    no_args_is_help=True,
+)
+app.add_typer(perms_app, name="perms")
+
+# Budget subcommand group (#244)
+budget_app = typer.Typer(
+    name="budget",
+    help="Manage agent cost budgets.",
+    no_args_is_help=True,
+)
+app.add_typer(budget_app, name="budget")
+
+# Sister subcommand group
+sister_app = typer.Typer(
+    name="sister",
+    help="Manage sister instances for cross-machine monitoring.",
+    no_args_is_help=False,
+    invoke_without_command=True,
+)
+app.add_typer(sister_app, name="sister")
+
+# Config subcommand group
+config_app = typer.Typer(
+    name="config",
+    help="Manage configuration",
+    no_args_is_help=False,
+    invoke_without_command=True,
+)
+app.add_typer(config_app, name="config")
+
+# Console for rich output
+console = Console()
+
+# Global session option (hidden advanced usage)
+SessionOption = Annotated[
+    str,
+    typer.Option(
+        "--session",
+        hidden=True,
+        help="Tmux session name for agents",
+    ),
+]
+
+
+def _parse_duration(s: str) -> float:
+    """Parse a duration string like '5m', '1h', '30s', '90' into seconds."""
+    s = s.strip().lower()
+    if s.endswith('s'):
+        return float(s[:-1])
+    elif s.endswith('m'):
+        return float(s[:-1]) * 60
+    elif s.endswith('h'):
+        return float(s[:-1]) * 3600
+    else:
+        return float(s)
+
+
+@app.callback(invoke_without_command=True)
+def main_callback(ctx: typer.Context):
+    """Launch the TUI monitor when no command is given."""
+    if ctx.invoked_subcommand is None:
+        from ..tui import run_tui
+
+        run_tui("agents")