deputy-cc 0.2.0__tar.gz

deputy_cc-0.2.0/.claude-plugin/marketplace.json

@@ -0,0 +1,15 @@
+{
+  "name": "deputy",
+  "description": "Deputy: a cheap model reviews Claude's code for bugs and gives second opinions, while Claude stays the lead.",
+  "owner": {
+    "name": "Amirhossein Alimohammadi",
+    "url": "https://github.com/alimohammadiamirhossein"
+  },
+  "plugins": [
+    {
+      "name": "deputy",
+      "source": "./",
+      "description": "DeepSeek V4.1 Flash reviews Claude's code for bugs, gives second opinions and searches code, for under a cent each. Claude keeps writing the code; an optional savings mode delegates coding work."
+    }
+  ]
+}

deputy_cc-0.2.0/.claude-plugin/plugin.json

@@ -0,0 +1,57 @@
+{
+  "name": "deputy",
+  "displayName": "Deputy",
+  "version": "0.2.0",
+  "description": "Deputize cheap models. Claude stays the sheriff. A cheap model, DeepSeek V4.1 Flash, reviews Claude's code for bugs and gives second opinions, for under a cent each. Claude keeps writing the code; an optional savings mode delegates coding work.",
+  "author": {
+    "name": "Amirhossein Alimohammadi",
+    "url": "https://github.com/alimohammadiamirhossein"
+  },
+  "homepage": "https://github.com/alimohammadiamirhossein/deputy",
+  "repository": "https://github.com/alimohammadiamirhossein/deputy",
+  "license": "MIT",
+  "icon": "./.claude-plugin/icon.png",
+  "keywords": ["subagent", "deepseek", "deepinfra", "mcp", "cost-optimization", "token-savings", "second-opinion", "coding-agent"],
+  "mcpServers": {
+    "deputy": {
+      "command": "uvx",
+      "args": ["--from", "${CLAUDE_PLUGIN_ROOT}", "deputy", "serve"],
+      "env": {
+        "DEPUTY_API_KEY": "${user_config.deepinfra_api_key}",
+        "DEPUTY_THINKING": "${user_config.thinking}",
+        "DEPUTY_MODE": "${user_config.mode}",
+        "DEPUTY_LEAD_MODEL": "${user_config.lead_model}",
+        "DEPUTY_WORKSPACE": "${CLAUDE_PROJECT_DIR}"
+      }
+    }
+  },
+  "userConfig": {
+    "mode": {
+      "type": "string",
+      "title": "Mode",
+      "description": "accuracy (recommended): Claude writes all code, Deputy only gives second opinions and reviews. balanced: Deputy also takes low-risk mechanical work. savings: Deputy takes most coding work.",
+      "options": ["accuracy", "balanced", "savings"],
+      "default": "accuracy"
+    },
+    "deepinfra_api_key": {
+      "type": "string",
+      "title": "DeepInfra API key",
+      "description": "Your key from deepinfra.com (Dashboard > API Keys). Stored in your system's secure storage. Leave empty to use the DEEPINFRA_API_KEY environment variable instead.",
+      "sensitive": true
+    },
+    "thinking": {
+      "type": "string",
+      "title": "Thinking level",
+      "description": "How hard DeepSeek thinks. high is the recommended default; max is slower and costs more.",
+      "options": ["high", "max"],
+      "default": "high"
+    },
+    "lead_model": {
+      "type": "string",
+      "title": "Your Claude model (for the savings estimate)",
+      "description": "Which Claude model you usually run. Deputy prices its savings estimate against it.",
+      "options": ["opus", "sonnet", "haiku", "fable"],
+      "default": "opus"
+    }
+  }
+}

deputy_cc-0.2.0/.github/workflows/ci.yml

@@ -0,0 +1,25 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        python: ["3.10", "3.12", "3.13"]
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python }}
+      - run: python -m pip install -e ".[dev]"
+      - run: python -m pytest -q

deputy_cc-0.2.0/.github/workflows/release.yml

@@ -0,0 +1,99 @@
+name: Release
+
+# Push a tag like v0.2.0 to publish to PyPI and the MCP Registry and create a GitHub release.
+# One-time setup: add a trusted publisher on pypi.org (project deputy-cc, workflow release.yml,
+# environment pypi). No API tokens are stored in the repo.
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: "3.12"
+      - name: Check the tag matches every version field
+        run: |
+          tag="${GITHUB_REF_NAME#v}"
+          python - "$tag" <<'EOF'
+          import json, sys, tomllib
+          tag = sys.argv[1]
+          found = {
+              "pyproject.toml": tomllib.load(open("pyproject.toml", "rb"))["project"]["version"],
+              "server.json": json.load(open("server.json"))["version"],
+              "server.json package": json.load(open("server.json"))["packages"][0]["version"],
+              "plugin.json": json.load(open(".claude-plugin/plugin.json"))["version"],
+          }
+          bad = {name: version for name, version in found.items() if version != tag}
+          if bad:
+              sys.exit(f"tag v{tag} does not match: {bad}")
+          EOF
+      - run: python -m pip install -e ".[dev]" build
+      - run: python -m pytest -q
+      - run: python -m build
+      - uses: actions/upload-artifact@v4
+        with:
+          name: dist
+          path: dist/
+
+  pypi:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/p/deputy-cc
+    permissions:
+      id-token: write
+    steps:
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - uses: pypa/gh-action-pypi-publish@release/v1
+
+  mcp-registry:
+    needs: pypi
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v4
+      - name: Wait until PyPI serves the new version
+        run: |
+          for i in $(seq 1 30); do
+            curl -sf "https://pypi.org/pypi/deputy-cc/${GITHUB_REF_NAME#v}/json" > /dev/null && exit 0
+            sleep 10
+          done
+          echo "PyPI never showed the new version" && exit 1
+      - name: Install mcp-publisher
+        run: |
+          curl -sL "https://github.com/modelcontextprotocol/registry/releases/download/v1.8.4/mcp-publisher_linux_amd64.tar.gz" | tar xz mcp-publisher
+      - run: ./mcp-publisher login github-oidc
+      - run: ./mcp-publisher publish
+
+  github-release:
+    needs: pypi
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+        with:
+          name: dist
+          path: dist/
+      - name: Create the release with this version's changelog
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          version="${GITHUB_REF_NAME#v}"
+          awk -v v="$version" 'index($0, "## [") == 1 { found = index($0, "## [" v "]") == 1; next } found' CHANGELOG.md > notes.md
+          gh release create "$GITHUB_REF_NAME" dist/* --title "Deputy $version" --notes-file notes.md

deputy_cc-0.2.0/.gitignore

@@ -0,0 +1,20 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+build/
+dist/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.coverage
+htmlcov/
+.env
+.env.*
+.idea/
+.vscode/
+.DS_Store
+
+# benchmark transcripts (results.md and results.json are kept)
+bench/results/**/*.jsonl

deputy_cc-0.2.0/CHANGELOG.md

@@ -0,0 +1,55 @@
+# Changelog
+
+All notable changes to Deputy. The format follows [Keep a Changelog](https://keepachangelog.com/),
+and versions follow [Semantic Versioning](https://semver.org/).
+
+## [0.2.0] - 2026-10-24
+
+### Added
+
+- **Accuracy mode, now the default.** Claude writes all code itself and uses the cheap model only
+  as extra eyes. Delegation happens only on request, or in the new `balanced` and `savings` modes.
+  Set it with the plugin option or `DEPUTY_MODE`.
+- **`review` tool.** Independent reviewers, one per lens, check the uncommitted git diff (or a
+  given `base`, `paths` or `diff`) with an adversarial prompt. Findings ask for impact, a repro and
+  a fix.
+- **`consult` `my_view`.** Records Claude's conclusion before it sees the helper's ideas; it is
+  never sent to the model.
+- `/deputy:review` skill, a mode-aware delegate skill, the `SKILL.md` playbook and
+  `docs/REFERENCE.md`.
+- PyPI package [`deputy-cc`](https://pypi.org/project/deputy-cc/): run `uvx deputy-cc serve` in
+  any MCP client.
+- Official MCP Registry entry (`io.github.alimohammadiamirhossein/deputy`), `llms.txt`, and a
+  benchmark harness in `bench/`.
+- **Savings estimate.** Each result ends with a rough "this work would cost $X on your lead model;
+  Deputy did it for $Y" line. The new `stats` tool and `deputy stats` command show totals for the
+  session, today, the last 7 days and all time; reviews and second opinions are listed as extra
+  checks, never as savings. Set the lead model with `DEPUTY_LEAD_MODEL` or the plugin option. The
+  log stores numbers only.
+- **Cursor and Codex support.** `deputy setup cursor` and `deputy setup codex` add Deputy to the
+  editor's MCP config (with a backup) and install the playbook as a Cursor rule or Codex skill;
+  Codex gets a 30-minute tool timeout. Copy-paste files are in `integrations/`.
+- **Workspace detection for any client.** Deputy asks the client for its project folder (MCP
+  roots), and every tool accepts `project_dir`, so it works when an editor starts it outside the
+  project.
+
+### Changed
+
+- Server instructions now depend on the mode.
+- Prompts include today's date, and APIs the model doesn't know are marked `[unverified]`.
+- Shorter README with measured costs and a "when to use, and when not to" section.
+
+## [0.1.0] - 2026-10-23
+
+### Added
+
+- First release: an MCP server and Claude Code plugin that runs DeepSeek V4.1 Flash on DeepInfra
+  (thinking `high`) as a helper.
+- `delegate` (coding sub-agent with its own tool loop), `investigate` (read-only search),
+  `consult` (parallel second opinions) and `status`.
+- Workspace jail, read-only tool sets, secret-free shell environment, and limits on turns, tokens
+  and time.
+- `deputy doctor` to check the key, the endpoint and that thinking is on.
+
+[0.2.0]: https://github.com/alimohammadiamirhossein/deputy/compare/2347242...v0.2.0
+[0.1.0]: https://github.com/alimohammadiamirhossein/deputy/commit/2347242

deputy_cc-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Amirhossein Alimohammadi
+
+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.

deputy_cc-0.2.0/PKG-INFO

@@ -0,0 +1,232 @@
+Metadata-Version: 2.5
+Name: deputy-cc
+Version: 0.2.0
+Summary: Claude Code plugin and MCP server that has a cheap model, DeepSeek V4.1 Flash, review Claude's code for bugs and give second opinions, for under a cent each. Claude keeps writing the code.
+Project-URL: Homepage, https://github.com/alimohammadiamirhossein/deputy
+Project-URL: Repository, https://github.com/alimohammadiamirhossein/deputy
+Project-URL: Issues, https://github.com/alimohammadiamirhossein/deputy/issues
+Project-URL: Changelog, https://github.com/alimohammadiamirhossein/deputy/blob/main/CHANGELOG.md
+Author: Amirhossein Alimohammadi
+License: MIT
+License-File: LICENSE
+Keywords: agentic-coding,ai-agent,ai-code-review,anthropic,claude,claude-code,claude-code-plugin,code-review,coding-agent,cost-optimization,deepinfra,deepseek,deepseek-v4,llm,mcp,mcp-server,model-context-protocol,second-opinion,subagent,token-savings
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+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 :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development
+Requires-Python: >=3.10
+Requires-Dist: mcp<2,>=1.20
+Requires-Dist: openai<3,>=1.40
+Provides-Extra: dev
+Requires-Dist: pytest>=8; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+<!-- mcp-name: io.github.alimohammadiamirhossein/deputy -->
+
+<img src="https://raw.githubusercontent.com/alimohammadiamirhossein/deputy/main/.claude-plugin/icon.png" alt="Deputy sheriff badge logo" width="128" height="128">
+
+# Deputy
+
+### Deputize cheap models. Claude stays the sheriff.
+
+**Deputy is a Claude Code plugin and MCP server that has a cheap model, DeepSeek V4.1 Flash, review
+Claude's code for bugs and give second opinions, for under a cent each. Claude keeps writing the
+code.**
+
+[![GitHub stars](https://img.shields.io/github/stars/alimohammadiamirhossein/deputy?style=social)](https://github.com/alimohammadiamirhossein/deputy/stargazers)
+[![CI](https://github.com/alimohammadiamirhossein/deputy/actions/workflows/ci.yml/badge.svg)](https://github.com/alimohammadiamirhossein/deputy/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/deputy-cc.svg)](https://pypi.org/project/deputy-cc/)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/alimohammadiamirhossein/deputy/blob/main/LICENSE)
+[![MCP](https://img.shields.io/badge/protocol-MCP-purple.svg)](https://modelcontextprotocol.io/)
+
+</div>
+
+```bash
+claude plugin marketplace add alimohammadiamirhossein/deputy
+claude plugin install deputy@deputy
+```
+
+Inside Claude Code the same thing is `/plugin marketplace add alimohammadiamirhossein/deputy`.
+You need [uv](https://docs.astral.sh/uv/getting-started/installation/) and a
+[DeepInfra API key](#quick-start).
+
+## What it costs (measured)
+
+| Run | Time | Cost |
+|---|---|---|
+| `review`: two reviewers check a change with a planted off-by-one bug (both caught it) | 27 s | **$0.0011** |
+| `consult`: second opinions from 2 angles | 68 s | **$0.0018** |
+| `investigate`: list a project's functions and their tests | 18 s | **$0.0004** |
+| `delegate`: fix a bug, add 3 tests, run pytest until green | 46 s | **$0.0006** |
+
+Measured on a small demo project with thinking `high`. On real projects, expect `consult` and
+`review` to stay under $0.01. Every result shows its real tokens and cost.
+
+## What it does
+
+Claude (for example Opus 5.5) stays in charge and **writes the code**. Deputy adds four tools that
+run a much cheaper model as a helper inside your project:
+
+| Tool | What it does |
+|---|---|
+| **`review`** | Independent reviewers hunt for bugs in Claude's change before it calls the task done |
+| **`consult`** | Second opinions from 2–4 angles at once, before Claude commits to a plan |
+| **`investigate`** | Reads lots of code and returns `file:line` leads |
+| **`delegate`** | Hands a coding task to the cheap model (off by default; on request, or in savings mode) |
+| **`stats`** | Shows roughly how many tokens and dollars Deputy saved: this session, today, this week, all time |
+
+Claude treats everything Deputy says as an **unverified hint**: it checks each finding against
+the code and keeps only what holds up.
+
+### See what you saved
+
+Every result ends with a one-line estimate, for example from a real `investigate` run:
+
+```text
+Savings (rough): this work would cost about $0.0082 on Claude Opus 5.5; Deputy did it for $0.0001. Saved about $0.0074 and 2.0k Claude Opus 5.5 tokens.
+```
+
+Ask Claude for `stats`, or run `deputy stats`, for totals. Reviews and second opinions are listed
+separately as extra checks, so they never inflate the savings. The estimate assumes your lead
+model would use about as many tokens, so treat it as an order of magnitude. Only numbers are
+stored, never code or prompts. Set your lead model with `DEPUTY_LEAD_MODEL` (`opus`, `sonnet`,
+`haiku`, `fable` or `custom`).
+
+## When to use Deputy, and when not to
+
+**Use it for:**
+
+- Non-trivial changes where a missed bug costs more than a cent: logic, edge cases, refactors that
+  touch several files.
+- A second opinion before Claude commits to a design, without spending Claude tokens on it.
+- Wide reading in a big codebase, such as "where is this setting read?".
+- Well-specified mechanical work (boilerplate, renames, test scaffolding) in `balanced` or
+  `savings` mode, when you want to save Claude tokens.
+
+**Skip it for:**
+
+- Trivial edits like typos and one-liners. A review takes 30–60 seconds and adds little there.
+- Code you may not share with a third party. Deputy sends code to DeepInfra, or to whatever
+  endpoint you set in `DEPUTY_BASE_URL` (a local model works too).
+- Final answers. Findings come from a weaker model and include false positives, which is why
+  Claude verifies every one.
+- Architecture and security-sensitive decisions in `savings` mode. Keep those with Claude.
+
+## Quick start
+
+**1. Get a DeepInfra API key** (DeepInfra hosts DeepSeek's models in the US)
+
+1. Sign up at **[deepinfra.com](https://deepinfra.com/)** with GitHub, Google or email.
+2. In **Dashboard → Billing**, add a card and **$5–10** of credit, then set a **spending limit**
+   equal to that amount.
+3. In **API Keys**, create a key (it starts with `sk-di-`) and copy it. Keep it private.
+
+You don't need a plan, a model purchase or a dedicated GPU. Pay-as-you-go credit is enough.
+
+**2. Install** [uv](https://docs.astral.sh/uv/getting-started/installation/) and the plugin
+
+```bash
+claude plugin marketplace add alimohammadiamirhossein/deputy
+claude plugin install deputy@deputy
+```
+
+Claude Code asks for your DeepInfra key and stores it in your system's secure storage.
+
+**3. Restart Claude Code and try it**
+
+```text
+/deputy:review
+/deputy:consult I plan to cache sessions in Redis. What am I missing?
+/deputy:investigate how does a request reach the database?
+```
+
+Or just work normally: Claude consults and reviews on its own for non-trivial tasks.
+
+### Cursor and Codex
+
+One command adds Deputy to the editor's MCP config (with a backup of the old file) and installs
+the playbook as a Cursor rule or Codex skill:
+
+```bash
+uvx --from git+https://github.com/alimohammadiamirhossein/deputy deputy setup cursor --project .
+uvx --from git+https://github.com/alimohammadiamirhossein/deputy deputy setup codex
+```
+
+Set `DEEPINFRA_API_KEY` in your environment first, then restart the editor. Add `--dry-run` to
+see the changes without writing them. Ready-made files are in
+[integrations/](https://github.com/alimohammadiamirhossein/deputy/tree/main/integrations).
+
+### Other MCP clients (Cline, Windsurf, Claude Desktop)
+
+Deputy is on PyPI as [`deputy-cc`](https://pypi.org/project/deputy-cc/). Add a stdio MCP server
+that runs:
+
+```bash
+uvx deputy-cc serve
+```
+
+with `DEEPINFRA_API_KEY` set in its environment. Check your setup with `uvx deputy-cc doctor`.
+
+## Recommended model: DeepSeek V4.1 Flash, thinking `high`
+
+The default is `deepseek-ai/DeepSeek-V4.1-Flash-1017` on DeepInfra with thinking set to `high`.
+It's the best price-to-quality option we found for this job:
+
+- **Cheap:** $0.098 per 1M input tokens and $0.294 per 1M output tokens (October 2026), cheaper
+  than DeepSeek's own API.
+- **Capable:** about 1M tokens of context and reliable tool calling.
+- **Thinking actually on:** DeepInfra leaves its thinking **off** unless asked. Deputy always asks
+  (`high`), which we confirmed by measuring the reasoning tokens.
+- **Private:** DeepInfra says it doesn't train on your data. Your code isn't sent to DeepSeek's
+  own servers.
+
+## Modes
+
+| Mode | Who writes the code | Pick it when |
+|---|---|---|
+| **accuracy** (default) | Claude, always | You want the best result |
+| **balanced** | Claude; Deputy takes boilerplate | You want some savings without risk |
+| **savings** | Deputy, Claude verifies | You want to save the most tokens |
+
+Change it in the plugin settings (`/plugin`) or with `DEPUTY_MODE`.
+
+## Learn more
+
+- **[SKILL.md](https://github.com/alimohammadiamirhossein/deputy/blob/main/SKILL.md)**: the
+  playbook Claude follows (consult → decide → implement → review → check each finding). Also works
+  without the plugin.
+- **[docs/REFERENCE.md](https://github.com/alimohammadiamirhossein/deputy/blob/main/docs/REFERENCE.md)**:
+  all settings, costs, safety, terms of service, the research behind the design, troubleshooting
+  and the roadmap.
+- **[CHANGELOG.md](https://github.com/alimohammadiamirhossein/deputy/blob/main/CHANGELOG.md)**:
+  what changed in each release.
+
+Deputy stays within Anthropic's rules: Claude Code runs unmodified, and Deputy never touches your
+Claude login. It's an ordinary MCP tool using your own DeepInfra key.
+
+## Support the project
+
+If Deputy caught a bug for you, **[give it a ⭐](https://github.com/alimohammadiamirhossein/deputy/stargazers)**
+and share it with someone who uses Claude Code. Issues and pull requests are welcome; the
+[good first issues](https://github.com/alimohammadiamirhossein/deputy/labels/good%20first%20issue)
+are a good place to start.
+
+[![Star History Chart](https://api.star-history.com/svg?repos=alimohammadiamirhossein/deputy&type=Date)](https://star-history.com/#alimohammadiamirhossein/deputy&Date)
+
+---
+
+[MIT](https://github.com/alimohammadiamirhossein/deputy/blob/main/LICENSE) © 2026 Amirhossein
+Alimohammadi · Not affiliated with Anthropic, DeepSeek or DeepInfra.
+
+<sub>Keywords: Claude Code plugin, MCP server, Model Context Protocol, AI code review, second
+opinion, DeepSeek V4.1 Flash, DeepInfra, subagent, Opus, agentic coding, reduce Claude Code cost.</sub>