{"_id":"@bytetrue/xxcoder","name":"@bytetrue/xxcoder","dist-tags":{"latest":"0.1.3"},"versions":{"0.1.3":{"name":"@bytetrue/xxcoder","version":"0.1.3","description":"Multi-model agent orchestration for Claude Code — route tasks to GPT, Gemini, Grok, GLM via codeagent-wrapper","type":"module","bin":{"xxcoder":"bin/xx.mjs"},"keywords":["claude-code","agent","orchestration","multi-model","cli","codex","gemini","opencode","multi-agent"],"author":{"name":"ByteTrue"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/ByteTrue/xxcoder.git"},"homepage":"https://github.com/ByteTrue/xxcoder#readme","bugs":{"url":"https://github.com/ByteTrue/xxcoder/issues"},"scripts":{"test":"vitest run","test:watch":"vitest","test:go":"cd codeagent-wrapper && make test","lint":"eslint .","lint:fix":"eslint --fix .","lint:go":"cd codeagent-wrapper && make lint","test:all":"npm run lint && npm test && npm run test:go","prepare":"husky"},"engines":{"node":">=18.3.0"},"dependencies":{"@inquirer/select":"^5.1.0","ansis":"^4.2.0","cac":"^6.7.14","inquirer":"^13.2.2","ora":"^9.3.0"},"devDependencies":{"@eslint/js":"^10.0.1","eslint":"^10.0.1","eslint-plugin-n":"^17.24.0","husky":"^9.1.7","lint-staged":"^16.2.7","vitest":"^4.0.18"},"_id":"@bytetrue/xxcoder@0.1.3","gitHead":"2619855090d2c46495b27936744c320ee8327d01","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-hntpG4pSXVqyFnz+CdO2uK5dEZv7ZjuXdBVscnThDMrmcj4nhwMRz8kztno0sZUIZB83ptAFg9QB12heoyzmxQ==","shasum":"c60357cf68f845c3024d0d543cb418762ec4a251","tarball":"https://registry.npmjs.org/@bytetrue/xxcoder/-/xxcoder-0.1.3.tgz","fileCount":37,"unpackedSize":69452558,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBSYQj3D1UKXiS8/hWjYBB/JsHb8xy6KxZK2IOpUsnxjAiEA1bZbaNRVuTk7iPPwcQI7TSkuBmc9Bm72sWDmvP1maWE="}]},"_npmUser":{"name":"bytetrue","email":"bytetrue@outlook.com"},"directories":{},"maintainers":[{"name":"bytetrue","email":"bytetrue@outlook.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/xxcoder_0.1.3_1771868875570_0.48677144799144645"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-23T17:47:55.493Z","0.1.3":"2026-02-23T17:47:56.610Z","modified":"2026-02-23T17:47:56.802Z"},"maintainers":[{"name":"bytetrue","email":"bytetrue@outlook.com"}],"description":"Multi-model agent orchestration for Claude Code — route tasks to GPT, Gemini, Grok, GLM via codeagent-wrapper","homepage":"https://github.com/ByteTrue/xxcoder#readme","keywords":["claude-code","agent","orchestration","multi-model","cli","codex","gemini","opencode","multi-agent"],"repository":{"type":"git","url":"git+https://github.com/ByteTrue/xxcoder.git"},"author":{"name":"ByteTrue"},"bugs":{"url":"https://github.com/ByteTrue/xxcoder/issues"},"license":"MIT","readme":"# xxcoder\n\nMulti-model agent orchestration for Claude Code. Route tasks to GPT, Gemini, Grok, GLM and more via the included codeagent-wrapper.\n\n## What is this?\n\nxxcoder adds a team of specialized AI agents to your Claude Code session. Instead of doing everything with one model, Sisyphus (the orchestrator) delegates tasks to the best-fit agent:\n\n| Agent | Model | Role |\n|-------|-------|------|\n| xx-oracle | GPT-5.2 | Architecture consultation, code review, complex debugging |\n| xx-developer | GPT-5.3-codex | Autonomous deep implementation |\n| xx-explorer | opencode/kimi-k2.5 | Fast codebase search, pattern discovery |\n| xx-librarian | opencode/kimi-k2.5 | Documentation search, GitHub exploration |\n| xx-looker | Gemini-3-flash | Screenshot/diagram/PDF analysis |\n| xx-planner | GPT-5.2 | Pre-planning, intent analysis, requirement discovery |\n| xx-reviewer | GPT-5.2 | Plan verification, solution review |\n\n## ✨ New in v0.2.0\n\n- **🎯 Interactive Installation Wizard** - Guided setup with module selection and backend configuration\n- **🔧 Modular Agent Selection** - Choose only the agents you need\n- **⚙️ Configuration Management** - New `xxcoder config` command suite\n- **⚡ Performance Improvements** - 4x faster backend checks with parallel execution\n- **📚 Comprehensive Documentation** - Complete usage guides and design docs\n\n## Quick Start\n\n### Installation\n\n```bash\n# Install globally\nnpm install -g .\n\n# Or run directly\nnpx xxcoder\n```\n\n### Interactive Setup (Recommended)\n\n```bash\n# Launch interactive installation wizard\nxxcoder init\n```\n\nThe wizard will guide you through:\n\n1. **Selecting installation location** (user directory / project directory / custom)\n2. **Choosing agents to install** (select only what you need)\n3. **Configuring backend API keys** (interactive, secure input)\n4. **Verifying your setup** (automatic checks)\n\n### Quick Install (Non-Interactive)\n\n```bash\n# Install all components to user directory\nxxcoder init --user\n\n# Install to project directory\nxxcoder init --project\n```\n\n### Verify Installation\n\n```bash\n# Check backend CLI availability\nxxcoder doctor\n\n# Validate configuration\nxxcoder config validate\n\n# View current configuration\nxxcoder config show\n```\n\n## Prerequisites\n\nxxcoder requires backend CLIs to communicate with different model providers:\n\n| Backend | Agents | Install |\n|---------|--------|---------|\n| [codex](https://github.com/openai/codex) | oracle, developer, planner, reviewer | `npm i -g @openai/codex` |\n| [gemini](https://github.com/google-gemini/gemini-cli) | looker | `npm i -g @google/gemini-cli` |\n| [opencode](https://github.com/opencode-ai/opencode) | explorer, librarian | `go install github.com/opencode-ai/opencode@latest` |\n\n**Note**: You only need the backends for the agents you plan to use. The interactive installer will help you configure only what's needed.\n\n## Configuration Management\n\n### View Configuration\n\n```bash\n# Show all backends\nxxcoder config show\n\n# Show specific backend\nxxcoder config show --backend codex\n```\n\n### Configure Backend\n\n```bash\n# Interactive configuration\nxxcoder config setup --backend codex\n\n# Edit configuration file directly\nxxcoder config edit\n\n# Validate configuration\nxxcoder config validate\n\n# Reset to defaults\nxxcoder config reset\n```\n\n## Usage\n\n1. **Install and configure**: `xxcoder init`\n2. **Restart Claude Code** to load the new agents\n3. **Activate orchestration**: Type `/xx` in any Claude Code session\n4. **Start working**: Ask questions like \"Help me refactor this code\"\n\nSisyphus will automatically route your request to the best agent based on the task type.\n\n## Documentation\n\n- **[CLI Usage Guide](CLI_USAGE_GUIDE.md)** - Complete command reference and examples\n- **[Interactive Install Design](INTERACTIVE_INSTALL_DESIGN.md)** - Design documentation for the installation wizard\n- **[Optimization Summary](OPTIMIZATION_SUMMARY.md)** - Overview of recent improvements\n- **[CLI Improvement Plan](CLI_IMPROVEMENT_PLAN.md)** - Roadmap and future enhancements\n\n## Advanced Topics\n\n### Rebuilding the Wrapper\n\nIf you're developing this repo and need to rebuild the wrapper manually (Go 1.21+ required):\n\n```bash\ncd codeagent-wrapper\nmake build\nmkdir -p ~/.claude/bin\ncp codeagent-wrapper ~/.claude/bin/\n```\n\nIf `xxcoder doctor` reports `wrapper INVALID`, the packaged binary architecture is mismatched. Rebuild locally or replace binaries before reinstalling.\n\n### OpenCode Model IDs\n\nFor OpenCode-backed agents, model IDs must use `provider/model` format. Check available IDs:\n\n```bash\nopencode models\n```\n\nAdjust `~/.codeagent/models.json` if needed.\n\n### Manual Activation\n\nxxcoder does not rely on a global `CLAUDE.md` prompt. Orchestration is activated manually via `/xx` in each session where you want it enabled.\n\n## Troubleshooting\n\n### Agent not working?\n\n```bash\n# 1. Check backend CLIs\nxxcoder doctor\n\n# 2. Validate configuration\nxxcoder config validate\n\n# 3. View configuration details\nxxcoder config show\n\n# 4. Reconfigure if needed\nxxcoder config setup --backend <name>\n```\n\n### Configuration issues?\n\n```bash\n# Edit configuration file\nxxcoder config edit\n\n# Or reset to defaults\nxxcoder config reset\n```\n\n### Need to reinstall?\n\n```bash\n# Uninstall first\nxxcoder uninstall --user\n\n# Then reinstall\nxxcoder init\n```\n\n## How it works\n\n```\nUser request\n  → Claude Code session\n    → manual `/xx` activation\n    → xx orchestration skill (Sisyphus routing brain)\n      → Task subagent (thin proxy agent)\n      → codeagent-wrapper → backend CLI (oracle/developer/explorer/librarian/looker/planner/reviewer)\n```\n\nAll 7 `xx-*` subagents are thin Claude Code proxies that call `codeagent-wrapper`, pass role + task prompts to the target backend/model, then return the backend output to the main session.\n\n## Project structure\n\n```\nxxcoder/\n├── bin/xx.mjs                  # CLI entry point\n├── src/commands/               # init, doctor commands\n├── codeagent-wrapper/          # Go source — bridge between Claude Code and backend CLIs\n├── docs/                       # project planning/archive docs\n├── templates/\n│   ├── agents/xx/              # 7 Claude Code subagent definitions (.md with frontmatter)\n│   ├── prompts/                # 7 codeagent-wrapper role prompts (minimal system prompts)\n│   ├── config/                 # models.json.example\n│   ├── hooks/                  # pre-bash.py (dangerous command blocker)\n│   └── skills/xx/SKILL.md      # Sisyphus orchestration brain\n```\n\n`agents/xx/*.md` — Full agent definitions used when invoked as Claude Code Task subagents (with frontmatter: model, tools, maxTurns).\n\n`prompts/*.md` — Minimal role prompts passed to target models when invoked via codeagent-wrapper.\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-947e1b8330ca3b16b55eccb438b82131"}