ai-agent-rules 0.11.0__py3-none-any.whl

ai_agent_rules-0.11.0.dist-info/METADATA

@@ -0,0 +1,390 @@
+Metadata-Version: 2.4
+Name: ai-agent-rules
+Version: 0.11.0
+Summary: Manage user-level AI agent configurations
+Author-email: Will Pfleger <pfleger.will@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/willpfleger/ai-rules
+Project-URL: Repository, https://github.com/willpfleger/ai-rules
+Project-URL: Issues, https://github.com/willpfleger/ai-rules/issues
+Keywords: ai,cli,configuration,claude,goose,llm,agent
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: click>=8.1
+Requires-Dist: hatch>=1.15.1
+Requires-Dist: packaging>=21.0
+Requires-Dist: pytest>=8.4.2
+Requires-Dist: pytest-cov>=7.0.0
+Requires-Dist: pytest-xdist>=3.8.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.0
+Requires-Dist: ruff>=0.14.3
+Requires-Dist: tomli>=2.0.0; python_version < "3.11"
+Dynamic: license-file
+
+# AI Rules
+
+Manage AI agent configurations through symlinks. Keep all your configs in one git-tracked location.
+
+[![PyPI Downloads](https://img.shields.io/pypi/dm/ai-agent-rules.svg)](https://pypi.org/project/ai-agent-rules/)
+[![PyPI version](https://img.shields.io/pypi/v/ai-agent-rules.svg)](https://pypi.org/project/ai-agent-rules/)
+[![Python Versions](https://img.shields.io/pypi/pyversions/ai-agent-rules.svg)](https://pypi.org/project/ai-agent-rules/)
+[![CI](https://github.com/wpfleger96/ai-rules/actions/workflows/ci.yml/badge.svg)](https://github.com/wpfleger96/ai-rules/actions/workflows/ci.yml)
+[![GitHub Contributors](https://img.shields.io/github/contributors/wpfleger96/ai-rules.svg)](https://github.com/wpfleger96/ai-rules/graphs/contributors)
+[![Lines of Code](https://aschey.tech/tokei/github/wpfleger96/ai-rules?category=code)](https://github.com/wpfleger96/ai-rules)
+[![License](https://img.shields.io/github/license/wpfleger96/ai-rules.svg)](https://github.com/wpfleger96/ai-rules/blob/main/LICENSE)
+
+## Overview
+
+Consolidates config files for AI coding agents (Claude Code, Goose) into a single source of truth via symlinks:
+
+- Git-tracked configs synced across machines
+- Edit once, apply everywhere
+- Exclude specific files (e.g., company-managed)
+- Per-agent customizations
+
+**Supported:** Claude Code (settings, agents, commands), Goose (hints, config), Shared (AGENTS.md)
+
+## Installation
+
+**Requirements:** Python 3.10+, [uv](https://github.com/astral-sh/uv)
+
+### From PyPI (Recommended)
+
+One-command setup from PyPI:
+
+```bash
+uvx --from ai-agent-rules ai-rules setup
+```
+
+This will:
+1. Install AI agent configuration symlinks
+2. Make `ai-rules` available system-wide
+3. Auto-install optional tools (claude-code-statusline)
+
+After setup, you can run `ai-rules` from any directory.
+
+### Local Development
+
+For contributing or local development:
+
+```bash
+git clone https://github.com/wpfleger96/ai-rules.git
+cd ai-rules
+uv tool install -e .
+ai-rules install
+```
+
+### Updating
+
+Check for and install updates:
+
+```bash
+ai-rules upgrade              # Check and install updates
+ai-rules upgrade --check      # Only check for updates
+```
+
+Auto-update checks run weekly by default. Configure in `~/.ai-rules/update_config.yaml`:
+
+```yaml
+enabled: true
+frequency: weekly  # daily, weekly, never
+notify_only: false
+```
+
+## Usage
+
+### User-Level Configuration
+
+```bash
+ai-rules setup                      # One-time setup: install symlinks + make available system-wide
+ai-rules upgrade                    # Upgrade to latest version
+ai-rules upgrade --check            # Check for updates without installing
+
+ai-rules install                    # Install all agent configs + optional tools
+ai-rules install --agents claude    # Install specific agents
+ai-rules install --dry-run          # Preview changes
+ai-rules install --force            # Skip confirmations
+ai-rules install --rebuild-cache    # Rebuild merged settings cache
+
+ai-rules status                     # Check symlink status + optional tools (✓✗⚠○)
+ai-rules diff                       # Show config differences
+ai-rules validate                   # Verify source files exist
+ai-rules update                     # Re-sync after adding files
+ai-rules uninstall                  # Remove all symlinks
+ai-rules list-agents                # Show available agents
+```
+
+### Configuration Management
+
+```bash
+# Interactive wizard for first-time setup
+ai-rules config init                # Start configuration wizard
+
+# View configuration
+ai-rules config show                # Show raw config files
+ai-rules config show --merged       # Show merged settings with overrides
+ai-rules config show --agent claude # Show config for specific agent
+ai-rules config edit                # Edit user config in $EDITOR
+
+# Manage exclusions
+ai-rules exclude add "~/.claude/*.json"      # Add exclusion pattern (supports globs)
+ai-rules exclude remove "~/.claude/*.json"   # Remove exclusion pattern
+ai-rules exclude list                        # List all exclusions
+
+# Manage settings overrides (for machine-specific settings)
+ai-rules override set claude.model "claude-sonnet-4-5-20250929"  # Set simple override
+ai-rules override set claude.hooks.SubagentStop[0].hooks[0].command "script.py"  # Array notation
+ai-rules override unset claude.model         # Remove override
+ai-rules override list                       # List all overrides
+```
+
+## Configuration
+
+### Quick Start with Config Wizard
+
+Run the interactive configuration wizard for guided setup:
+
+```bash
+ai-rules config init
+```
+
+This will walk you through:
+1. Selecting common exclusions
+2. Adding custom exclusion patterns (with glob support)
+3. Setting up machine-specific settings overrides
+
+### User-Level Config
+
+Create `~/.ai-rules-config.yaml` for user-level settings:
+
+```yaml
+version: 1
+
+# Global exclusions (apply to all contexts)
+# Supports glob patterns: *.json, **/*.yaml, etc.
+exclude_symlinks:
+  - "~/.config/goose/config.yaml"
+  - "~/.claude/*.log"              # Glob: exclude all log files
+  - "~/.claude/agents/debug-*.md"  # Glob: exclude debug agents
+
+# Machine-specific settings overrides
+# Keeps repo settings.json synced via git, but allows local overrides
+settings_overrides:
+  claude:
+    model: "claude-sonnet-4-5-20250929"  # Override model on personal laptop
+    # Other settings inherited from base config/claude/settings.json
+  goose:
+    provider: "anthropic"
+```
+
+**Config File Location:**
+- `~/.ai-rules-config.yaml` - User-specific config (exclusions and overrides)
+
+### Settings Overrides - Syncing Configs Across Machines
+
+**Problem:** You want to sync your `settings.json` via git, but need different settings on different machines (e.g., different model access on work vs personal laptop).
+
+**Solution:** Use `settings_overrides` in your user config:
+
+```yaml
+# ~/.ai-rules-config.yaml on personal laptop
+settings_overrides:
+  claude:
+    model: "claude-sonnet-4-5-20250929"  # No Opus access
+
+# ~/.ai-rules-config.yaml on work laptop
+settings_overrides:
+  claude:
+    model: "claude-opus-4-20250514"  # Has Opus access
+```
+
+Both machines sync the same `config/claude/settings.json` via git, but each has different local overrides. The system merges them at install time:
+
+1. **Base settings** from `config/claude/settings.json` (git-tracked)
+2. **Merged with** overrides from `~/.ai-rules-config.yaml` (local only)
+3. **Cached** in `~/.ai-rules/cache/claude/settings.json`
+4. **Symlinked** to `~/.claude/settings.json`
+
+After changing overrides, run:
+```bash
+ai-rules install --rebuild-cache
+```
+
+#### Array Notation for Nested Settings
+
+Override commands support array index notation for complex nested structures:
+
+```bash
+# Override nested array elements (e.g., hooks)
+ai-rules override set claude.hooks.SubagentStop[0].hooks[0].command "uv run ~/my-hook.py"
+
+# Override environment variables
+ai-rules override set claude.env.MY_VAR "value"
+
+# The system validates paths and provides helpful suggestions
+ai-rules override set claude.modle "sonnet"
+# Error: Key 'modle' not found at 'modle'
+# Available options: model, env, hooks, statusLine, ...
+```
+
+Path validation ensures you only set valid overrides that exist in the base settings, preventing typos and configuration errors.
+
+## Structure
+
+```
+config/
+├── AGENTS.md              # User-level rules → ~/AGENTS.md, ~/.CLAUDE.md, ~/.config/goose/.goosehints
+├── claude/
+│   ├── settings.json      # → ~/.claude/settings.json
+│   ├── agents/*.md        # → ~/.claude/agents/*.md (dynamic)
+│   └── commands/*.md      # → ~/.claude/commands/*.md (dynamic)
+└── goose/
+    └── config.yaml        # → ~/.config/goose/config.yaml
+```
+
+## Optional Tools
+
+AI Rules automatically installs optional tools that enhance functionality:
+
+- **claude-code-statusline** - Custom status line for Claude Code showing token usage, git info, time, and workspace details
+
+These tools are installed automatically during `setup` and `install` commands. Check installation status:
+
+```bash
+ai-rules status  # Shows Optional Tools section
+```
+
+If a tool fails to install, ai-rules continues normally (fail-open behavior).
+
+## Extending
+
+**Add Claude agent/command:**
+1. Create `config/claude/agents/my-agent.md` or `config/claude/commands/my-cmd.md`
+2. Run `ai-rules update`
+
+**Add new AI tool:**
+1. Add configs to `config/<tool>/`
+2. Implement `ai_rules/agents/<tool>.py`
+3. Register in `ai_rules/cli.py::get_agents()`
+
+## Safety
+
+- First-run warnings
+- Timestamped backups (`*.ai-rules-backup.YYYYMMDD-HHMMSS`)
+- Interactive prompts and dry-run mode
+- Only manages symlinks (never deletes real files)
+- Contextual error messages with tips
+
+## Development
+
+### Quick Start with Just
+
+This project uses [just](https://github.com/casey/just) for task automation.
+
+**Install just**:
+```bash
+# macOS
+brew install just
+
+# Linux
+cargo install just
+# or: sudo apt install just (Ubuntu 23.04+)
+
+# Windows
+choco install just
+```
+
+**Common commands**:
+```bash
+just              # Run quick quality checks (sync, type-check, lint-check, format-check)
+just --list       # List all available recipes
+
+# Setup
+just setup        # First-time setup: sync deps + install git hooks
+just sync         # Sync dependencies only
+
+# Code Quality
+just check        # Quick quality checks (no tests)
+just check-all    # All checks including tests
+just lint         # Fix linting issues
+just format       # Auto-format code
+just type-check   # Run mypy type checking
+
+# Testing
+just test         # Run all tests (default config)
+just test-unit    # Unit tests only
+just test-integration  # Integration tests only
+just test-cov     # Tests with coverage report
+
+# Benchmarking
+just benchmark-save     # Run and save baseline
+just benchmark-compare  # Compare against baseline
+just benchmark-record   # Compare and save
+just benchmark-list     # List saved benchmarks
+just benchmark-clean    # Remove all benchmarks
+
+# Build
+just build        # Build package
+just rebuild      # Clean and build
+```
+
+### Running Tests
+The test suite includes both unit tests and integration tests.
+
+Using just (recommended):
+```bash
+just test         # Run all tests with default config
+just test-unit    # Only unit tests
+just test-integration  # Only integration tests
+just test-cov     # Tests with coverage report
+```
+
+Using uv directly:
+```bash
+uv run pytest [--cov=src --cov-report=term-missing]  # All tests
+uv run pytest -m unit      # Unit tests only
+uv run pytest -m integration  # Integration tests only
+```
+
+## Troubleshooting
+
+**Wrong target:** `ai-rules status` then `ai-rules install --force`
+
+**Restore backup:**
+```bash
+ls -la ~/.CLAUDE.md.ai-rules-backup.*
+mv ~/.CLAUDE.md.ai-rules-backup.20250104-143022 ~/.CLAUDE.md
+```
+
+**Disable symlink:** Use the exclude command or add to config manually:
+```bash
+ai-rules exclude add "~/.claude/settings.json"
+# Or edit manually: ai-rules config edit
+```
+
+**Override not applying:** Rebuild the merged settings cache:
+```bash
+ai-rules install --rebuild-cache
+```
+
+**View merged settings:** Check what's actually being applied:
+```bash
+ai-rules config show --merged
+ai-rules config show --merged --agent claude
+```
+
+## License
+
+MIT

ai_agent_rules-0.11.0.dist-info/RECORD

@@ -0,0 +1,42 @@
+ai_agent_rules-0.11.0.dist-info/licenses/LICENSE,sha256=eRdOpQ8Kaod-FPwMA-sD9U2817DCp0QNub7f_UpqMe0,1070
+ai_rules/__init__.py,sha256=h0sNb8H1ED7Dy0IXON1Ww3O8cls08Sr_g1osdcQ-4i0,231
+ai_rules/cli.py,sha256=oSxAP5cZlv6LXW81zhDslMR17lpwwp0Ss_IICdVwNQg,77887
+ai_rules/completions.py,sha256=7Ymgfzd93Owlscfn6sWkopbbAfT_J5PXnY5vl3CN_Xs,5736
+ai_rules/config.py,sha256=_updV-Uk2eHN1QK0GiVJv_hlvGefloxPZawisK-K9oA,20943
+ai_rules/display.py,sha256=dltgyoJZSseP1xrj-YBvj8_TOBSTouoiQMjwdC5d2MI,1225
+ai_rules/mcp.py,sha256=jbUgRaIyglVfwIFu61Dbtsbbk_o87NCTYwVgz4VclQ8,11958
+ai_rules/symlinks.py,sha256=gXBVMcDU96pMHXR675ePZSnXKY9d0kEEwXnUazd0xhw,6674
+ai_rules/agents/__init__.py,sha256=VG6BFISMVTETyfs7aAXTa_co6NH_dmvp_5aw09HI35w,32
+ai_rules/agents/base.py,sha256=vVPEkdczTz8oLUS5XdjHrJbARL2kDfaKDwQOVBX6bYI,1981
+ai_rules/agents/claude.py,sha256=5O4e_cOxBdPGYEkL-_pevQquSU7VRb9ohxx6Grn89ko,3756
+ai_rules/agents/goose.py,sha256=7zkXWtSZIdnfCEg3k_2-eUOL9bnIQ2HOInBupELRIrc,1077
+ai_rules/agents/shared.py,sha256=Tj9ll1Z_wZzwM19368r2ku_6aTQYyNCwxzOc_4lXqqg,839
+ai_rules/bootstrap/__init__.py,sha256=HTykRNzbh8-kAByfRlvbeS0pefrbR4VlA4AS-5lwcpY,1840
+ai_rules/bootstrap/config.py,sha256=Cp133LLC2xnyM-RRtmKsZ73cSMdm8GVzCmwHjFrcK1I,6970
+ai_rules/bootstrap/installer.py,sha256=5t0XJh4yKtaXxA5SnprK62eNalNUdrKBWQ-TFhIFpKg,6757
+ai_rules/bootstrap/updater.py,sha256=kW9YUy4DT1F1nNRIvjDHkiuNaLoFP7V4RhbDZO0TiKs,6202
+ai_rules/bootstrap/version.py,sha256=WCj4LwzZk-M62ViOf6qg7mQPk-AlGswwHsJWfv9bEko,1236
+ai_rules/config/AGENTS.md,sha256=BKch0ZjjTZfzBRJ6n_UWrLfrWKu3WtNh7DR-4mRY2-w,11298
+ai_rules/config/chat_agent_hints.md,sha256=lW3nCigFn4iuZ6vsCjntwd-Po7MVGFZynjR9X5__vY0,491
+ai_rules/config/claude/mcps.json,sha256=yj0WO6sFU4GCciYUBWjzvvfqrBh869doeOC2Pp5EI1Y,3
+ai_rules/config/claude/settings.json,sha256=Kf1U5_F6V-c15ipiwAPwmuqiv1esOvl_uEE8PdaiA4E,2926
+ai_rules/config/claude/agents/code-reviewer.md,sha256=hFyRbuAzliQOmRVTTNAy1unV4Xx5kFb9JlWEwULL7nY,4417
+ai_rules/config/claude/commands/annotate-changelog.md,sha256=a9AL9Os8VLScL0hryHmesrMdusG2z0TTxH6myeu4aVU,5573
+ai_rules/config/claude/commands/comment-cleanup.md,sha256=gNLc36PlplP08By-QK4n44gefgPusSQa0lnLQDGujBA,5296
+ai_rules/config/claude/commands/continue-crash.md,sha256=rRi16p7PyS9IYuanuTUCh6fMmXleSoqbNqZFWzoJR0s,1378
+ai_rules/config/claude/commands/dev-docs.md,sha256=ZGHrrsbVwcMkgSGy0cQV-CTRUngHOxuCUiz7BUR3fkY,7258
+ai_rules/config/claude/commands/pr-creator.md,sha256=UnzDyxDdM9x0nLgOKag6lsfMrJ3FPDar01gIcQ5qVOo,8133
+ai_rules/config/claude/commands/test-cleanup.md,sha256=R1SeZ-vTxllh33ee-EI65IMnxKpQxJi70VhDvepc_xk,8109
+ai_rules/config/claude/commands/update-docs.md,sha256=R34D6QaLikZrXJD8iJn0RZ4DkhSqmsQASjZupBlFcxw,12289
+ai_rules/config/claude/hooks/subagentStop.py,sha256=woddjbsQSsukVfWaUMsb0D5vyqir75aMZ5a5KnD8HEI,2981
+ai_rules/config/claude/skills/doc-writer/SKILL.md,sha256=22SvAYgdGwKq5quUSgUsu9nGiDJh_6GEFnvlxa4oEuo,10550
+ai_rules/config/claude/skills/doc-writer/resources/templates.md,sha256=qGkqvY78N8DTox06nQWbGlCF62ckpiNHBiEd9l3blTY,11636
+ai_rules/config/claude/skills/prompt-engineer/SKILL.md,sha256=TA6c1SUvJKy0pQnTwGGj_IbQEXqe4wUrFZJuaBVpNJ4,9664
+ai_rules/config/claude/skills/prompt-engineer/resources/prompt_engineering_guide_2025.md,sha256=h3WlOQTYn1zGymJGSoD6dHCZsOTCe9Tne9a3tuRJFFQ,29592
+ai_rules/config/claude/skills/prompt-engineer/resources/templates.md,sha256=4gIR1i5k-_GxWrZXStFyYAEfqZJvzh1KngZfq1T2pLY,6856
+ai_rules/config/goose/config.yaml,sha256=N_QzIANL_7WnX5xSrMZN_t94wbrGXXHMleQ6gzzIaC8,1396
+ai_agent_rules-0.11.0.dist-info/METADATA,sha256=nRRbjUL974E67Oz5UlCx1WYKfzUoochYPPOaqPGQiTI,12546
+ai_agent_rules-0.11.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+ai_agent_rules-0.11.0.dist-info/entry_points.txt,sha256=Dnt2pQp6vSWz374RsUNZ5Zh5qmuTy45xR02r5fH_p_E,82
+ai_agent_rules-0.11.0.dist-info/top_level.txt,sha256=1jJObrxql_i5okMXb4dxsiQa_cpjtzwwskVvwedEHow,9
+ai_agent_rules-0.11.0.dist-info/RECORD,,

ai_agent_rules-0.11.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

ai_agent_rules-0.11.0.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[console_scripts]
+ai-agent-rules = ai_rules.cli:main
+ai-rules = ai_rules.cli:main

ai_agent_rules-0.11.0.dist-info/licenses/LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2025 Will Pfleger
+
+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.

ai_agent_rules-0.11.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+ai_rules

ai_rules/__init__.py

@@ -0,0 +1,8 @@
+"""AI Rules - Manage AI agent configurations through symlinks."""
+
+from importlib.metadata import PackageNotFoundError, version
+
+try:
+    __version__ = version("ai-agent-rules")
+except PackageNotFoundError:
+    __version__ = "dev"

ai_rules/agents/__init__.py

@@ -0,0 +1 @@
+"""AI agent implementations."""

ai_rules/agents/base.py

@@ -0,0 +1,68 @@
+"""Base agent class."""
+
+from abc import ABC, abstractmethod
+from functools import cached_property
+from pathlib import Path
+
+from ai_rules.config import Config
+
+
+class Agent(ABC):
+    """Base class for AI agent configuration managers."""
+
+    def __init__(self, config_dir: Path, config: Config):
+        self.config_dir = config_dir
+        self.config = config
+
+    @property
+    @abstractmethod
+    def name(self) -> str:
+        """Human-readable name of the agent."""
+        pass
+
+    @property
+    @abstractmethod
+    def agent_id(self) -> str:
+        """Short identifier for the agent (e.g., 'claude', 'goose')."""
+        pass
+
+    @property
+    @abstractmethod
+    def config_file_name(self) -> str:
+        """Config file name for the agent (e.g., 'settings.json', 'config.yaml')."""
+        pass
+
+    @property
+    @abstractmethod
+    def config_file_format(self) -> str:
+        """Config file format ('json' or 'yaml')."""
+        pass
+
+    @cached_property
+    @abstractmethod
+    def symlinks(self) -> list[tuple[Path, Path]]:
+        """Cached list of (target_path, source_path) tuples for symlinks.
+
+        Returns:
+            List of tuples where:
+            - target_path: Where symlink should be created (e.g., ~/.CLAUDE.md)
+            - source_path: What symlink should point to (e.g., repo/config/AGENTS.md)
+        """
+        pass
+
+    def get_filtered_symlinks(self) -> list[tuple[Path, Path]]:
+        """Get symlinks filtered by config exclusions."""
+        return [
+            (target, source)
+            for target, source in self.symlinks
+            if not self.config.is_excluded(str(target))
+        ]
+
+    def get_deprecated_symlinks(self) -> list[Path]:
+        """Get list of deprecated symlink paths that should be cleaned up.
+
+        Returns:
+            List of paths that were previously used but are now deprecated.
+            These will be removed during install if they point to our config files.
+        """
+        return []

ai_rules/agents/claude.py

@@ -0,0 +1,121 @@
+"""Claude Code agent implementation."""
+
+from functools import cached_property
+from pathlib import Path
+
+from ai_rules.agents.base import Agent
+from ai_rules.mcp import MCPManager, MCPStatus, OperationResult
+
+
+class ClaudeAgent(Agent):
+    """Agent for Claude Code configuration."""
+
+    DEPRECATED_SYMLINKS: list[Path] = [
+        Path("~/CLAUDE.md"),
+    ]
+
+    @property
+    def name(self) -> str:
+        return "Claude Code"
+
+    @property
+    def agent_id(self) -> str:
+        return "claude"
+
+    @property
+    def config_file_name(self) -> str:
+        return "settings.json"
+
+    @property
+    def config_file_format(self) -> str:
+        return "json"
+
+    @cached_property
+    def symlinks(self) -> list[tuple[Path, Path]]:
+        """Cached list of all Claude Code symlinks including dynamic agents/commands."""
+        result = []
+
+        result.append((Path("~/.claude/CLAUDE.md"), self.config_dir / "AGENTS.md"))
+
+        settings_file = self.config_dir / "claude" / "settings.json"
+        if settings_file.exists():
+            target_file = self.config.get_settings_file_for_symlink(
+                "claude", settings_file
+            )
+            result.append((Path("~/.claude/settings.json"), target_file))
+
+        agents_dir = self.config_dir / "claude" / "agents"
+        if agents_dir.exists():
+            for agent_file in sorted(agents_dir.glob("*.md")):
+                result.append(
+                    (
+                        Path(f"~/.claude/agents/{agent_file.name}"),
+                        agent_file,
+                    )
+                )
+
+        commands_dir = self.config_dir / "claude" / "commands"
+        if commands_dir.exists():
+            for command_file in sorted(commands_dir.glob("*.md")):
+                result.append(
+                    (
+                        Path(f"~/.claude/commands/{command_file.name}"),
+                        command_file,
+                    )
+                )
+
+        skills_dir = self.config_dir / "claude" / "skills"
+        if skills_dir.exists():
+            for skill_folder in sorted(skills_dir.glob("*")):
+                if skill_folder.is_dir():
+                    result.append(
+                        (
+                            Path(f"~/.claude/skills/{skill_folder.name}"),
+                            skill_folder,
+                        )
+                    )
+
+        return result
+
+    def get_deprecated_symlinks(self) -> list[Path]:
+        """Return deprecated symlink locations for cleanup."""
+        return self.DEPRECATED_SYMLINKS
+
+    def install_mcps(
+        self, force: bool = False, dry_run: bool = False
+    ) -> tuple[OperationResult, str, list[str]]:
+        """Install managed MCPs into ~/.claude.json.
+
+        Args:
+            force: Skip confirmation prompts
+            dry_run: Don't actually modify files
+
+        Returns:
+            Tuple of (result, message, conflicts_list)
+        """
+        manager = MCPManager()
+        return manager.install_mcps(self.config_dir, self.config, force, dry_run)
+
+    def uninstall_mcps(
+        self, force: bool = False, dry_run: bool = False
+    ) -> tuple[OperationResult, str]:
+        """Uninstall managed MCPs from ~/.claude.json.
+
+        Args:
+            force: Skip confirmation prompts
+            dry_run: Don't actually modify files
+
+        Returns:
+            Tuple of (result, message)
+        """
+        manager = MCPManager()
+        return manager.uninstall_mcps(force, dry_run)
+
+    def get_mcp_status(self) -> MCPStatus:
+        """Get status of managed and unmanaged MCPs.
+
+        Returns:
+            MCPStatus object with categorized MCPs
+        """
+        manager = MCPManager()
+        return manager.get_status(self.config_dir, self.config)