agent-notes 2.0.4__tar.gz → 2.9.0__tar.gz

agent_notes-2.9.0/PKG-INFO

@@ -0,0 +1,300 @@
+Metadata-Version: 2.4
+Name: agent-notes
+Version: 2.9.0
+Summary: AI agent configuration manager for Claude Code, OpenCode, and Copilot
+Author-email: Eugene Naumov <min.verkligheten@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/rubakas/agent-notes
+Project-URL: Repository, https://github.com/rubakas/agent-notes
+Project-URL: Issues, https://github.com/rubakas/agent-notes/issues
+Project-URL: Documentation, https://github.com/rubakas/agent-notes/tree/main/docs
+Keywords: claude,claude-code,opencode,ai-agent,agent,configuration,claude-cli,github-copilot
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Code Generators
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: tomli>=1.1.0; python_version < "3.11"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Dynamic: license-file
+
+# agent-notes
+
+AI agent configuration manager for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [OpenCode](https://github.com/opencode-ai/opencode).
+
+Configures a Lead agent (Opus) that orchestrates a team of 18 specialized subagents across three model tiers — so Opus plans and reasons, Sonnet executes, and Haiku explores.
+
+## Quick Start
+
+```bash
+pip install agent-notes
+agent-notes install    # interactive wizard guides you through setup
+agent-notes doctor
+```
+
+## What's Included
+
+| Component | Description |
+|-----------|-------------|
+| **Skills** | 42 on-demand knowledge modules (Rails, Docker, Git, Kamal, Process) |
+| **Agents** | 18 specialized AI subagents with hierarchical model strategy |
+| **Rules** | Global instructions, code quality, and safety guardrails |
+| **Config** | Global instructions for Claude Code, OpenCode, and GitHub Copilot |
+
+## Install Methods
+
+There are three ways to use agent-notes. Pick the one that matches your intent.
+
+### 1. Python package — PyPI (recommended)
+
+```bash
+pip install agent-notes
+# or
+pipx install agent-notes
+agent-notes install
+```
+
+Update anytime:
+
+```bash
+pip install --upgrade agent-notes && agent-notes install
+# or
+pipx upgrade agent-notes && agent-notes install
+```
+
+### 2. Python package — from local build (developers)
+
+```bash
+git clone https://github.com/rubakas/agent-notes.git
+cd agent-notes
+python -m build                    # produces dist/*.whl
+pipx install dist/*.whl            # or pip install --user dist/*.whl
+agent-notes install
+```
+
+Iteration loop: edit source → `python -m build` → `pipx reinstall dist/*.whl`. Not editable mode. Not `pip install -e .`.
+
+### 3. Plugin — limited functionality
+
+- **Claude Code**: install via the Claude Code plugin marketplace.
+- **OpenCode**: copy or symlink `.opencode-plugin/` into `~/.config/opencode/plugins/agent-notes/` and add `"plugin": ["agent-notes"]` to `opencode.json`.
+
+The plugin runs a `session.start` hook that surfaces agent-notes context to the CLI session. It does **not** include the full `agent-notes` CLI (wizard, doctor, config, memory, etc.). For those, use install method 1 or 2.
+
+### API keys
+
+Provider API keys live in `~/.agent-notes/credentials.toml` (mode 0600, never committed). Add or update via:
+
+```bash
+agent-notes config providers
+```
+
+The wizard prompts for the key with hidden input; agent-notes never logs or prints the value. To check whether a provider is configured without exposing the key:
+
+```bash
+agent-notes config provider openrouter   # prints "configured" or "no key"
+```
+
+## CLI Reference
+
+```
+agent-notes <command> [options]
+```
+
+| Command | Description |
+|---------|-------------|
+| `install [--local] [--copy]` | Interactive wizard or direct install |
+| `uninstall [--local]` | Remove installed components |
+| `update` | Pull latest, rebuild, reinstall |
+| `doctor [--local] [--fix]` | Check installation health |
+| `info` | Show status and component counts |
+| `list [clis\|models\|roles\|agents\|skills\|rules\|all]` | List engine components or installed |
+| `set role <role> <model> [--cli <cli>]` | Change model for a role (Phase 10+) |
+| `regenerate [--cli <cli>]` | Rebuild files from state.json (Phase 10+) |
+| `validate` | Lint source configuration files |
+| `memory [list\|size\|show\|reset\|export\|import] [name]` | Manage agent memory |
+
+### Supported platforms
+
+| Platform | Install target | Config format |
+|----------|---------------|---------------|
+| **Claude Code** | `~/.claude/` | YAML frontmatter + Markdown prompts |
+| **OpenCode** | `~/.config/opencode/` | YAML frontmatter + Markdown prompts |
+| **GitHub Copilot** | `~/.github/` | `copilot-instructions.md` |
+
+### Quick usage examples
+
+```bash
+# Interactive install (recommended)
+agent-notes install
+
+# Direct install (scripted)
+agent-notes install --local --copy
+
+# Check health and fix issues
+agent-notes doctor --fix
+
+# Manage agent memory
+agent-notes memory list
+agent-notes memory add "Rails enum prefix" \
+  "Always use _prefix: true to avoid method name collisions" \
+  pattern coder
+```
+
+## Agent Team
+
+Specialized subagents with hierarchical model strategy: **Opus 4.7 decides, Sonnet 4 executes, Haiku 4.5 explores.**
+
+| Agent | Model | Role |
+|-------|-------|------|
+| **lead** | Opus 4.7 | Plans, delegates, reviews. Orchestrator. |
+| **architect** | Opus 4.7 | System architecture, module boundaries, domain models. Read-only. |
+| **debugger** | Opus 4.7 | Bug investigation: reproduces, isolates, identifies root cause. Read-only. |
+| **coder** | Sonnet 4 | Implements features, fixes bugs, edits files. |
+| **reviewer** | Sonnet 4 | Code quality review. Read-only. |
+| **security-auditor** | Sonnet 4 | Security vulnerability analysis. Read-only. |
+| **test-writer** | Sonnet 4 | Writes tests for any framework. |
+| **test-runner** | Sonnet 4 | Diagnoses and fixes failing tests. |
+| **system-auditor** | Sonnet 4 | Codebase health: duplication, N+1, coupling. Read-only. |
+| **database-specialist** | Sonnet 4 | Schema design, indexes, query performance, migrations. Read-only. |
+| **performance-profiler** | Sonnet 4 | Response times, memory, caching, bundle size. Read-only. |
+| **devops** | Sonnet 4 | Docker, CI/CD, deployment configs. |
+| **devil** | Sonnet 4 | Challenges plans to surface hidden risks. Read-only. |
+| **integrations** | Sonnet 4 | Third-party integrations: OAuth, webhooks, payments. |
+| **refactorer** | Sonnet 4 | Improves code structure without changing behavior. |
+| **analyst** | Haiku 4.5 | Requirements analysis: surfaces missing or contradictory requirements. Read-only. |
+| **api-reviewer** | Haiku 4.5 | API design, versioning, error handling, backward compatibility. Read-only. |
+| **tech-writer** | Haiku 4.5 | Documentation: READMEs, API docs, changelogs. |
+| **explorer** | Haiku 4.5 | Fast file discovery and pattern search. Read-only. |
+
+## Architecture
+
+agent-notes is a 4-layer engine (domain / registries / services / commands). All extensible content (CLIs, models, roles, agents, skills, rules) lives in `agent_notes/data/` as YAML — adding a new CLI/model/role is a YAML drop, no Python changes. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/ADD_CLI.md](docs/ADD_CLI.md), [docs/ADD_MODEL.md](docs/ADD_MODEL.md), [docs/ADD_ROLE.md](docs/ADD_ROLE.md).
+
+## Improved Claude Code workflows
+
+Four failure modes that derail AI-assisted development, and the skills that address them. Inspired by [Matt Pocock's skills repo](https://github.com/mattpocock/skills).
+
+| Failure mode | What goes wrong | Skills that help |
+|---|---|---|
+| **Misalignment** | Claude starts building before the problem is resolved | `/grill-me`, `/grill-with-docs` |
+| **Verbosity** | Responses are bloated; context window fills with noise | `/caveman`, `/setup-project-context` |
+| **Broken code** | Claude codes without a feedback loop or evidence trail | `/tdd` (improved), `/debugging-protocol` (improved) |
+| **Ball of mud** | Architecture drifts; modules grow shallow and tangled | `/improve-codebase-architecture`, `/zoom-out` |
+
+- `/grill-me` — interview the user until the problem is fully resolved before touching code
+- `/grill-with-docs` — same, but cross-references CONTEXT.md and ADRs and updates them inline
+- `/caveman` — ultra-compressed reply mode (~75% token savings) for rapid iteration
+- `/setup-project-context` — bootstraps a CONTEXT.md domain glossary (ubiquitous language)
+- `/tdd` — RED-GREEN-REFACTOR with tracer-bullet vertical slices; horizontal-slicing anti-pattern added
+- `/debugging-protocol` — Phase 1 rewritten as "build a feedback loop first" with 9 strategies
+- `/improve-codebase-architecture` — deletion test to find shallow modules; surfaces deepening opportunities
+- `/zoom-out` — quick orientation map of an unfamiliar code area
+
+## Skills
+
+42 on-demand knowledge modules across Rails, Docker, Kamal, Git, and Process. Run `agent-notes list skills` for the current list, or browse `agent_notes/data/skills/`.
+
+### Using skills in Claude Code / OpenCode
+
+```
+Use the rails-models skill to help with this association
+Load the docker-compose skill for multi-service setup
+```
+
+## Agent Memory
+
+Agents accumulate knowledge across sessions using one of three backends, chosen during `agent-notes install`.
+
+### Backends
+
+| Backend | Storage | Best for |
+|---------|---------|----------|
+| **Local** | `~/.claude/agent-memory/<agent>/` — plain markdown per agent | Simple setup, no extra tools |
+| **Obsidian** | Category vault with YAML frontmatter and `[[wikilinks]]` | Visual browsing, backlinks, Dataview queries |
+| **None** | Disabled — no files written | Stateless or shared machines |
+
+### Obsidian setup
+
+Run `agent-notes install` and pick Obsidian when prompted. The wizard auto-detects existing vaults under `~/Documents`, `~/Desktop`, and `~`. To initialize the vault structure:
+
+```bash
+agent-notes memory init
+```
+
+The installed `CLAUDE.md` already points agents to your vault. At the start of a session Claude reads `Index.md`; at the end it can save insights with `agent-notes memory add`.
+
+### Memory commands
+
+```bash
+agent-notes memory init                    # create folder structure and Index.md
+agent-notes memory list                    # list all notes (by category or agent)
+agent-notes memory vault                   # show backend, path, and init status
+agent-notes memory index                   # regenerate Index.md
+agent-notes memory add <title> <body> [type] [agent] [project]   # type: pattern|decision|mistake|context|session
+agent-notes memory show <agent>            # show one agent's notes (local backend)
+agent-notes memory reset [agent]           # clear memory (confirmation required)
+agent-notes memory export                  # back up to memory-backup/
+agent-notes memory import                  # restore from memory-backup/
+agent-notes install --reconfigure          # switch backends
+```
+
+### Note format (Obsidian backend)
+
+Every note agent-notes writes includes YAML frontmatter for filtering and Dataview queries:
+
+```markdown
+---
+created_at: 2026-04-28T19:30:35Z
+type: pattern
+agent: coder
+project: rubakas
+tags: [rails, models]
+---
+
+# Rails Enum Prefix
+
+Always use `_prefix: true` with Rails enums to avoid method name collisions.
+```
+
+## Development
+
+Python 3.9+ required. Build from source and run tests:
+
+```bash
+python -m build && pipx install dist/*.whl
+python3 -m pytest tests/
+```
+
+Run `agent-notes build` after editing `agent_notes/data/` files, and `agent-notes validate` before committing.
+
+Tests live in `tests/functional/` (unit), `tests/integration/` (build output), and `tests/plugins/` (artifact validation).
+
+## Contributing
+
+When adding new content:
+
+1. **Edit source files** — all changes go in `agent_notes/data/` directory
+2. **Run build** — `agent-notes build` to generate platform configs
+3. **Validate** — `agent-notes validate` before committing
+4. **Keep it generic** — remove app-specific references
+5. **Show examples** — include code samples with explanations
+6. **Stay modular** — each skill should be independently usable
+7. **Stay concise** — agent prompts under 60 lines
+
+See [docs/](docs/) for full guidelines.
+
+## License
+
+MIT

agent_notes-2.9.0/README.md

@@ -0,0 +1,269 @@
+# agent-notes
+
+AI agent configuration manager for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) and [OpenCode](https://github.com/opencode-ai/opencode).
+
+Configures a Lead agent (Opus) that orchestrates a team of 18 specialized subagents across three model tiers — so Opus plans and reasons, Sonnet executes, and Haiku explores.
+
+## Quick Start
+
+```bash
+pip install agent-notes
+agent-notes install    # interactive wizard guides you through setup
+agent-notes doctor
+```
+
+## What's Included
+
+| Component | Description |
+|-----------|-------------|
+| **Skills** | 42 on-demand knowledge modules (Rails, Docker, Git, Kamal, Process) |
+| **Agents** | 18 specialized AI subagents with hierarchical model strategy |
+| **Rules** | Global instructions, code quality, and safety guardrails |
+| **Config** | Global instructions for Claude Code, OpenCode, and GitHub Copilot |
+
+## Install Methods
+
+There are three ways to use agent-notes. Pick the one that matches your intent.
+
+### 1. Python package — PyPI (recommended)
+
+```bash
+pip install agent-notes
+# or
+pipx install agent-notes
+agent-notes install
+```
+
+Update anytime:
+
+```bash
+pip install --upgrade agent-notes && agent-notes install
+# or
+pipx upgrade agent-notes && agent-notes install
+```
+
+### 2. Python package — from local build (developers)
+
+```bash
+git clone https://github.com/rubakas/agent-notes.git
+cd agent-notes
+python -m build                    # produces dist/*.whl
+pipx install dist/*.whl            # or pip install --user dist/*.whl
+agent-notes install
+```
+
+Iteration loop: edit source → `python -m build` → `pipx reinstall dist/*.whl`. Not editable mode. Not `pip install -e .`.
+
+### 3. Plugin — limited functionality
+
+- **Claude Code**: install via the Claude Code plugin marketplace.
+- **OpenCode**: copy or symlink `.opencode-plugin/` into `~/.config/opencode/plugins/agent-notes/` and add `"plugin": ["agent-notes"]` to `opencode.json`.
+
+The plugin runs a `session.start` hook that surfaces agent-notes context to the CLI session. It does **not** include the full `agent-notes` CLI (wizard, doctor, config, memory, etc.). For those, use install method 1 or 2.
+
+### API keys
+
+Provider API keys live in `~/.agent-notes/credentials.toml` (mode 0600, never committed). Add or update via:
+
+```bash
+agent-notes config providers
+```
+
+The wizard prompts for the key with hidden input; agent-notes never logs or prints the value. To check whether a provider is configured without exposing the key:
+
+```bash
+agent-notes config provider openrouter   # prints "configured" or "no key"
+```
+
+## CLI Reference
+
+```
+agent-notes <command> [options]
+```
+
+| Command | Description |
+|---------|-------------|
+| `install [--local] [--copy]` | Interactive wizard or direct install |
+| `uninstall [--local]` | Remove installed components |
+| `update` | Pull latest, rebuild, reinstall |
+| `doctor [--local] [--fix]` | Check installation health |
+| `info` | Show status and component counts |
+| `list [clis\|models\|roles\|agents\|skills\|rules\|all]` | List engine components or installed |
+| `set role <role> <model> [--cli <cli>]` | Change model for a role (Phase 10+) |
+| `regenerate [--cli <cli>]` | Rebuild files from state.json (Phase 10+) |
+| `validate` | Lint source configuration files |
+| `memory [list\|size\|show\|reset\|export\|import] [name]` | Manage agent memory |
+
+### Supported platforms
+
+| Platform | Install target | Config format |
+|----------|---------------|---------------|
+| **Claude Code** | `~/.claude/` | YAML frontmatter + Markdown prompts |
+| **OpenCode** | `~/.config/opencode/` | YAML frontmatter + Markdown prompts |
+| **GitHub Copilot** | `~/.github/` | `copilot-instructions.md` |
+
+### Quick usage examples
+
+```bash
+# Interactive install (recommended)
+agent-notes install
+
+# Direct install (scripted)
+agent-notes install --local --copy
+
+# Check health and fix issues
+agent-notes doctor --fix
+
+# Manage agent memory
+agent-notes memory list
+agent-notes memory add "Rails enum prefix" \
+  "Always use _prefix: true to avoid method name collisions" \
+  pattern coder
+```
+
+## Agent Team
+
+Specialized subagents with hierarchical model strategy: **Opus 4.7 decides, Sonnet 4 executes, Haiku 4.5 explores.**
+
+| Agent | Model | Role |
+|-------|-------|------|
+| **lead** | Opus 4.7 | Plans, delegates, reviews. Orchestrator. |
+| **architect** | Opus 4.7 | System architecture, module boundaries, domain models. Read-only. |
+| **debugger** | Opus 4.7 | Bug investigation: reproduces, isolates, identifies root cause. Read-only. |
+| **coder** | Sonnet 4 | Implements features, fixes bugs, edits files. |
+| **reviewer** | Sonnet 4 | Code quality review. Read-only. |
+| **security-auditor** | Sonnet 4 | Security vulnerability analysis. Read-only. |
+| **test-writer** | Sonnet 4 | Writes tests for any framework. |
+| **test-runner** | Sonnet 4 | Diagnoses and fixes failing tests. |
+| **system-auditor** | Sonnet 4 | Codebase health: duplication, N+1, coupling. Read-only. |
+| **database-specialist** | Sonnet 4 | Schema design, indexes, query performance, migrations. Read-only. |
+| **performance-profiler** | Sonnet 4 | Response times, memory, caching, bundle size. Read-only. |
+| **devops** | Sonnet 4 | Docker, CI/CD, deployment configs. |
+| **devil** | Sonnet 4 | Challenges plans to surface hidden risks. Read-only. |
+| **integrations** | Sonnet 4 | Third-party integrations: OAuth, webhooks, payments. |
+| **refactorer** | Sonnet 4 | Improves code structure without changing behavior. |
+| **analyst** | Haiku 4.5 | Requirements analysis: surfaces missing or contradictory requirements. Read-only. |
+| **api-reviewer** | Haiku 4.5 | API design, versioning, error handling, backward compatibility. Read-only. |
+| **tech-writer** | Haiku 4.5 | Documentation: READMEs, API docs, changelogs. |
+| **explorer** | Haiku 4.5 | Fast file discovery and pattern search. Read-only. |
+
+## Architecture
+
+agent-notes is a 4-layer engine (domain / registries / services / commands). All extensible content (CLIs, models, roles, agents, skills, rules) lives in `agent_notes/data/` as YAML — adding a new CLI/model/role is a YAML drop, no Python changes. See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md), [docs/ADD_CLI.md](docs/ADD_CLI.md), [docs/ADD_MODEL.md](docs/ADD_MODEL.md), [docs/ADD_ROLE.md](docs/ADD_ROLE.md).
+
+## Improved Claude Code workflows
+
+Four failure modes that derail AI-assisted development, and the skills that address them. Inspired by [Matt Pocock's skills repo](https://github.com/mattpocock/skills).
+
+| Failure mode | What goes wrong | Skills that help |
+|---|---|---|
+| **Misalignment** | Claude starts building before the problem is resolved | `/grill-me`, `/grill-with-docs` |
+| **Verbosity** | Responses are bloated; context window fills with noise | `/caveman`, `/setup-project-context` |
+| **Broken code** | Claude codes without a feedback loop or evidence trail | `/tdd` (improved), `/debugging-protocol` (improved) |
+| **Ball of mud** | Architecture drifts; modules grow shallow and tangled | `/improve-codebase-architecture`, `/zoom-out` |
+
+- `/grill-me` — interview the user until the problem is fully resolved before touching code
+- `/grill-with-docs` — same, but cross-references CONTEXT.md and ADRs and updates them inline
+- `/caveman` — ultra-compressed reply mode (~75% token savings) for rapid iteration
+- `/setup-project-context` — bootstraps a CONTEXT.md domain glossary (ubiquitous language)
+- `/tdd` — RED-GREEN-REFACTOR with tracer-bullet vertical slices; horizontal-slicing anti-pattern added
+- `/debugging-protocol` — Phase 1 rewritten as "build a feedback loop first" with 9 strategies
+- `/improve-codebase-architecture` — deletion test to find shallow modules; surfaces deepening opportunities
+- `/zoom-out` — quick orientation map of an unfamiliar code area
+
+## Skills
+
+42 on-demand knowledge modules across Rails, Docker, Kamal, Git, and Process. Run `agent-notes list skills` for the current list, or browse `agent_notes/data/skills/`.
+
+### Using skills in Claude Code / OpenCode
+
+```
+Use the rails-models skill to help with this association
+Load the docker-compose skill for multi-service setup
+```
+
+## Agent Memory
+
+Agents accumulate knowledge across sessions using one of three backends, chosen during `agent-notes install`.
+
+### Backends
+
+| Backend | Storage | Best for |
+|---------|---------|----------|
+| **Local** | `~/.claude/agent-memory/<agent>/` — plain markdown per agent | Simple setup, no extra tools |
+| **Obsidian** | Category vault with YAML frontmatter and `[[wikilinks]]` | Visual browsing, backlinks, Dataview queries |
+| **None** | Disabled — no files written | Stateless or shared machines |
+
+### Obsidian setup
+
+Run `agent-notes install` and pick Obsidian when prompted. The wizard auto-detects existing vaults under `~/Documents`, `~/Desktop`, and `~`. To initialize the vault structure:
+
+```bash
+agent-notes memory init
+```
+
+The installed `CLAUDE.md` already points agents to your vault. At the start of a session Claude reads `Index.md`; at the end it can save insights with `agent-notes memory add`.
+
+### Memory commands
+
+```bash
+agent-notes memory init                    # create folder structure and Index.md
+agent-notes memory list                    # list all notes (by category or agent)
+agent-notes memory vault                   # show backend, path, and init status
+agent-notes memory index                   # regenerate Index.md
+agent-notes memory add <title> <body> [type] [agent] [project]   # type: pattern|decision|mistake|context|session
+agent-notes memory show <agent>            # show one agent's notes (local backend)
+agent-notes memory reset [agent]           # clear memory (confirmation required)
+agent-notes memory export                  # back up to memory-backup/
+agent-notes memory import                  # restore from memory-backup/
+agent-notes install --reconfigure          # switch backends
+```
+
+### Note format (Obsidian backend)
+
+Every note agent-notes writes includes YAML frontmatter for filtering and Dataview queries:
+
+```markdown
+---
+created_at: 2026-04-28T19:30:35Z
+type: pattern
+agent: coder
+project: rubakas
+tags: [rails, models]
+---
+
+# Rails Enum Prefix
+
+Always use `_prefix: true` with Rails enums to avoid method name collisions.
+```
+
+## Development
+
+Python 3.9+ required. Build from source and run tests:
+
+```bash
+python -m build && pipx install dist/*.whl
+python3 -m pytest tests/
+```
+
+Run `agent-notes build` after editing `agent_notes/data/` files, and `agent-notes validate` before committing.
+
+Tests live in `tests/functional/` (unit), `tests/integration/` (build output), and `tests/plugins/` (artifact validation).
+
+## Contributing
+
+When adding new content:
+
+1. **Edit source files** — all changes go in `agent_notes/data/` directory
+2. **Run build** — `agent-notes build` to generate platform configs
+3. **Validate** — `agent-notes validate` before committing
+4. **Keep it generic** — remove app-specific references
+5. **Show examples** — include code samples with explanations
+6. **Stay modular** — each skill should be independently usable
+7. **Stay concise** — agent prompts under 60 lines
+
+See [docs/](docs/) for full guidelines.
+
+## License
+
+MIT

agent_notes-2.9.0/agent_notes/VERSION

@@ -0,0 +1 @@
+2.9.0

{agent_notes-2.0.4 → agent_notes-2.9.0}/agent_notes/cli.py

@@ -286,6 +286,19 @@ def main():
         help="Memory action")
     p_memory.add_argument("name", nargs="?", help="Agent name / note title (for show/reset/add)")
     p_memory.add_argument("extra", nargs="*", help="Additional args (for add: body [type] [agent] [project])")
+
+    # cost-report
+    p_cost_report = subparsers.add_parser("cost-report", help="Report token usage and cost for the current AI session")
+    p_cost_report.add_argument("--since", help="Only include messages at or after this UTC datetime (ISO 8601)")
+    p_cost_report.add_argument("--session", help="Session ID to report on (Claude Code only)")
+
+    # config
+    p_config = subparsers.add_parser("config", help="Reconfigure role/agent/model/memory/skill assignments after install")
+    p_config.add_argument("action", nargs="?", default="wizard",
+        choices=["wizard", "show", "role-model", "role-agent"],
+        help="Config action (default: wizard)")
+    p_config.add_argument("extra", nargs="*", help="Additional positional args (role, model, agent)")
+    p_config.add_argument("--cli", help="Target CLI (claude / opencode / both)")
     
     args = parser.parse_args()
     
@@ -343,6 +356,24 @@ def main():
     elif args.command == "memory":
         from .commands.memory import memory
         memory(args.action, args.name, getattr(args, "extra", None))
+    elif args.command == "config":
+        from .commands.config import config
+        config(action=args.action, args=getattr(args, "extra", None) or [], cli_filter=args.cli)
+    elif args.command == "cost-report":
+        # Rebuild sys.argv slice so cost_report.main() can parse it normally
+        argv = []
+        if args.since:
+            argv += ["--since", args.since]
+        if args.session:
+            argv += ["--session", args.session]
+        import sys
+        old_argv = sys.argv
+        sys.argv = ["agent-notes cost-report"] + argv
+        try:
+            from .scripts.cost_report import main as _cost_report_main
+            sys.exit(_cost_report_main())
+        finally:
+            sys.argv = old_argv
 
 if __name__ == "__main__":
     main()

{agent_notes-2.0.4 → agent_notes-2.9.0}/agent_notes/commands/_install_helpers.py

@@ -5,7 +5,7 @@ from pathlib import Path
 from typing import List
 
 from ..config import (
-    ROOT, DIST_CLAUDE_DIR, DIST_OPENCODE_DIR, DIST_GITHUB_DIR, DIST_RULES_DIR, DIST_SKILLS_DIR, DIST_SCRIPTS_DIR,
+    ROOT, DIST_CLAUDE_DIR, DIST_OPENCODE_DIR, DIST_GITHUB_DIR, DIST_RULES_DIR, DIST_SKILLS_DIR,
     CLAUDE_HOME, OPENCODE_HOME, GITHUB_HOME, AGENTS_HOME, BIN_HOME,
     linked, removed, skipped, info, get_version, Color, PKG_DIR
 )
@@ -17,11 +17,6 @@ from ..services.fs import (
 )
 
 
-def install_scripts_global() -> None:
-    """Install scripts to ~/.local/bin/."""
-    from ..services.installer import install_scripts_global as _service_impl
-    _service_impl()
-
 
 def _install_skills_to(targets: List[Path], dist_skills_dir: Path, copy_mode: bool) -> None:
     """Install skills from dist_skills_dir to each directory in targets."""
@@ -108,11 +103,6 @@ def install_rules_local(copy_mode: bool = False) -> None:
         place_dir_contents(DIST_RULES_DIR, Path(".claude/rules"), "*.md", copy_mode)
 
 
-def uninstall_scripts_global() -> None:
-    """Uninstall scripts from ~/.local/bin/."""
-    from ..services.installer import uninstall_scripts_global as _service_impl
-    _service_impl()
-
 
 def _uninstall_skills_from(targets: List[Path]) -> None:
     """Remove skills from each directory in targets."""
@@ -183,10 +173,6 @@ def uninstall_rules_local() -> None:
     )
 
 
-def count_scripts() -> int:
-    """Count script files."""
-    return len([f for f in DIST_SCRIPTS_DIR.iterdir() if f.is_file()]) if DIST_SCRIPTS_DIR.exists() else 0
-
 
 def count_skills() -> int:
     """Count skill directories."""
@@ -196,16 +182,13 @@ def count_skills() -> int:
 
 
 def count_agents(backend) -> int:
-    """Count agent *.md files in backend's dist directory. Returns 0 if backend
+    """Count agents for backend from the canonical YAML source. Returns 0 if backend
     doesn't support agents."""
-    from ..services import installer
-    from ..domain.cli_backend import CLIBackend
     if not backend.supports("agents"):
         return 0
-    src = installer.dist_source_for(backend, "agents")
-    if src is None or not src.exists():
-        return 0
-    return len(list(src.glob("*.md")))
+    from ..registries.agent_registry import load_agent_registry
+    registry = load_agent_registry()
+    return sum(1 for a in registry.all() if not a.excluded_from(backend.name))
 
 
 def count_global() -> int: