Conjure

Delegate tasks to external models from Claude Code. Delegate analysis, bulk work, and summarization to Gemini, Qwen, MiniMax, GLM, Meta Muse, Codex, OpenCode, or a Muse Glimmer running locally.

Track quotas, log usage, and suggest delegation for large tasks.

Installation

As a Claude Code plugin

/plugin install athola@claude-night-market
/status

Development setup

uv sync             # install deps
make install-hooks  # pre-commit hooks
make test           # lint + type + security checks

Requirements: Python 3.10+, uv.

Optional Dependencies

For accurate token counts, install tiktoken:

pip install tiktoken

Why delegation is on by default

It was opt-in until the provider chain landed, under [docs/inclusive-defaults.md][inc] TRUE-exception category 3: the external CLIs (gemini, qwen, mmx, muse, codex, opencode, claude, ollama) are separately installed and authenticated, and smart_delegate raised when none of them was. Defaulting on would have failed every task on an unconfigured machine.

The chain removed that failure. An unconfigured machine now costs one availability probe per provider and gets a providers_exhausted result, which the caller reads as "do this work yourself". The reasonable default the category asked for exists, and it is "try, then do it yourself".

Skill(conjure:provider-setup) is how an operator stops paying that cost. It prints which CLIs are installed and authenticated, explains each unhealthy one, installs the missing ones after confirmation, and stores the result at ~/.claude/hooks/delegation/provider-state.json:

python3 scripts/delegation_setup.py --available
python3 scripts/delegation_setup.py --doctor
python3 scripts/delegation_setup.py --install gemini

Two switches decline it, environment over file:

A disabled delegator probes and spawns nothing.

[inc]: ../../docs/inclusive-defaults.md

Usage

Quick Start

# Check delegation readiness
make delegate-verify

# Select best service for a task
make delegate-auto PROMPT="Summarize src" FILES="src/"

# Monitor limits and usage
make quota-status
make usage-report

Delegation Executor

# List services
uv run python scripts/delegation_executor.py --list-services

# Verify a service
uv run python scripts/delegation_executor.py --verify gemini

# Auto-select a service for the task
uv run python scripts/delegation_executor.py auto "Analyze this code" \
  --files src/

# Force a specific service
uv run python scripts/delegation_executor.py gemini "Summarize" \
  --files docs/*.md --model gemini-3-pro

Make Commands

# Development
make format          # ruff format + check --fix
make lint            # ruff check
make typecheck       # mypy + ty
make security-check  # bandit
make test            # lint + type + security bundle
make validate-all    # full validation including hooks
make clean           # remove caches/venv

# Delegation lifecycle
make delegate-status
make delegate-verify
make delegate-usage
make delegate-test
make delegate-gemini PROMPT="Analyze" FILES="src/main.py"
make delegate-qwen   PROMPT="Extract" FILES="src/**/*.py"
make delegate-minimax PROMPT="Summarize" FILES="src/**/*.py"
make delegate-glm     PROMPT="Review this design"
…

Quota & Usage Tools

# Quota tracker (Gemini)
uv run python tools/quota_tracker.py --status
uv run python tools/quota_tracker.py --estimate src/ docs/
uv run python tools/quota_tracker.py --validate-config

# Usage logger (Gemini)
uv run python tools/usage_logger.py --report
uv run python tools/usage_logger.py --validate
uv run python tools/usage_logger.py --status

In Claude Code

Use skills directly in chat:

Skill(conjure:delegation-core)
Skill(conjure:gemini-delegation)
Skill(conjure:qwen-delegation)
Skill(conjure:minimax-delegation)
Skill(conjure:glm-delegation)
Skill(conjure:muse-delegation)
Skill(conjure:codex-delegation)
Skill(conjure:opencode-delegation)

Hooks surface delegation suggestions for large tasks.

Commands

delegate-auto

Select the best external service based on requirements.

delegate-

Force a specific service with optional file globs and model hints. One target per registered provider: gemini, qwen, minimax, glm, muse, codex, opencode, glimmer.

delegate-setup / delegate-doctor / delegate-install

Report which provider CLIs are present and authenticated, name the command that fixes each unhealthy one, and install the missing ones after a confirmation showing the package, publisher, and source URL. Install commands come only from the vetted provenance map, so an unrecorded binary is refused rather than guessed at.