{"_id":"@carrier-sh/carrier","name":"@carrier-sh/carrier","dist-tags":{"latest":"0.2.0"},"versions":{"0.2.0":{"name":"@carrier-sh/carrier","version":"0.2.0","description":"Fleet orchestration system for Claude Code","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"carrier":"dist/cli.js"},"scripts":{"build":"bun build src/cli.ts --outdir dist --target bun --format esm && bun build src/carrier-dispatch.ts --outdir dist --target bun --format esm","dev":"bun src/cli.ts","carrier":"bun src/cli.ts","lint":"tsc --noEmit","test":"bun test","test:watch":"bun test --watch","test:fast":"bun test --bail","test:api":"bun test tests/api.test.ts"},"keywords":["claude-code","orchestration","workflow","agent","fleet","typescript"],"author":{"name":"Carrier Team"},"license":"AGPL-3.0-or-later","engines":{"bun":">=1.0.0"},"devDependencies":{"@types/node":"^20.0.0","bun-types":"^1.2.21","typescript":"^5.0.0"},"directories":{"doc":"docs","test":"tests"},"dependencies":{"bson":"^6.10.4","csstype":"^3.1.3","memory-pager":"^1.5.0","mongodb":"^6.19.0","mongodb-connection-string-url":"^3.0.2","punycode":"^2.3.1","sparse-bitfield":"^3.0.3","tr46":"^5.1.1","undici-types":"^6.21.0","webidl-conversions":"^7.0.0","whatwg-url":"^14.2.0"},"repository":{"type":"git","url":"git+https://github.com/carrier-sh/carrier.git"},"bugs":{"url":"https://github.com/carrier-sh/carrier/issues"},"homepage":"https://github.com/carrier-sh/carrier#readme","_id":"@carrier-sh/carrier@0.2.0","gitHead":"6d6c9aaaf49aaf1f3bd1a9ec87551e9710c35520","_nodeVersion":"23.10.0","_npmVersion":"10.9.2","dist":{"integrity":"sha512-n/XdJ1lmcoByXuWgOyK5mtHMk/FVF42VOJBHFJ20qW0Vq5YIqQl7+XhEQACb63xNuGEnvWD9CLD7LMVoTYr0kg==","shasum":"137c19452204318b82d1c3deeb10950a02f6ee40","tarball":"https://registry.npmjs.org/@carrier-sh/carrier/-/carrier-0.2.0.tgz","fileCount":20,"unpackedSize":261684,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCdM5uqPhUBt2sxjmg0DkHbt/J4G3y0ItqlgT24fOrm6QIgN2vSPy0sred+ScJRCx2nj0WizipqFmQKEkJlNgaXGbU="}]},"_npmUser":{"name":"buhrerm","email":"buhrerm@gmail.com"},"maintainers":[{"name":"buhrerm","email":"buhrerm@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/carrier_0.2.0_1758637465565_0.8201340103026717"},"_hasShrinkwrap":false}},"time":{"created":"2025-09-23T14:24:25.463Z","0.2.0":"2025-09-23T14:24:25.722Z","modified":"2025-09-23T14:24:26.016Z"},"maintainers":[{"name":"buhrerm","email":"buhrerm@gmail.com"}],"description":"Fleet orchestration system for Claude Code","homepage":"https://github.com/carrier-sh/carrier#readme","keywords":["claude-code","orchestration","workflow","agent","fleet","typescript"],"repository":{"type":"git","url":"git+https://github.com/carrier-sh/carrier.git"},"author":{"name":"Carrier Team"},"bugs":{"url":"https://github.com/carrier-sh/carrier/issues"},"license":"AGPL-3.0-or-later","readme":"# Carrier\n\n[![License: AGPL v3](https://img.shields.io/badge/License-AGPL%20v3-blue.svg)](https://www.gnu.org/licenses/agpl-3.0)\n[![Bun](https://img.shields.io/badge/runtime-bun-ff69b4)](https://bun.sh)\n[![TypeScript](https://img.shields.io/badge/language-TypeScript-blue)](https://www.typescriptlang.org/)\n\n> Zero-touch orchestration framework for complex development workflows\n\nCarrier is a CLI tool that manages sophisticated multi-agent workflows through fleet-based execution with subagent delegation, conditional routing, and approval gates. It integrates seamlessly with Claude Code to enable complex development tasks.\n\n## ✨ Features\n\n- **Fleet-Based Orchestration**: Reusable workflow templates with task sequencing\n- **Subagent Delegation**: Each task runs with dedicated AI agents and fresh context\n- **Conditional Routing**: Smart task routing based on execution outcomes\n- **Approval Gates**: Human oversight at critical workflow points\n- **Claude Code Integration**: Native support for `/carrier` commands\n- **Remote API**: Cloud-based fleet management with GitHub OAuth\n- **File-Based State**: No database required - uses JSON persistence\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- [Bun](https://bun.sh) v1.0.0 or later\n- Git\n- Node.js compatible environment\n\n### Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/carrier-sh/carrier.git\ncd carrier\n\n# Install dependencies\nbun install\n\n# Build the project\nbun run build\n\n# Initialize Carrier (local project)\ncarrier init\n\n# Or initialize globally (system-wide)\ncarrier init --global\n\n# Optional: Enable autocomplete\necho \"source $(pwd)/scripts/autocomplete.sh\" >> ~/.bashrc\n```\n\n### First Deployment\n\n```bash\n# List available fleets\ncarrier ls\n\n# Deploy a fleet with your request\ncarrier deploy simple-code-change \"Add error handling to the login function\"\n\n# Monitor execution\ncarrier monitor\n\n# Check status\ncarrier status\n```\n\n## 📖 Documentation\n\n### Core Concepts\n\n#### Fleet\nReusable workflow blueprint defining tasks, routing, and approval points.\n\n```json\n{\n  \"id\": \"example-fleet\",\n  \"description\": \"Example workflow\",\n  \"tasks\": [\n    {\n      \"id\": \"analyzer\", \n      \"agent\": \"code-analyzer.md\",\n      \"nextTasks\": [{\"taskId\": \"executor\", \"condition\": \"success\"}]\n    }\n  ]\n}\n```\n\n#### Deployed Fleet\nActive instance executing tasks with isolated state and outputs.\n\n#### Task\nIndividual work unit executed by specialized AI agents with defined inputs and outputs.\n\n### Authentication\n\n```bash\n# Authenticate with GitHub OAuth\ncarrier auth\n\n# Check current user\ncarrier whoami\n\n# Logout\ncarrier logout\n```\n\n### Fleet Management\n\n```bash\n# List fleets\ncarrier ls                    # Remote fleets\ncarrier ls --testing          # Local fleets\n\n# Push/pull fleets\ncarrier push my-fleet         # To remote\ncarrier pull code-review      # From remote\n\n# Remove fleets\ncarrier rm my-fleet --remote  # From remote\ncarrier rm my-fleet --testing # From local\n```\n\n### Deployment Operations\n\n```bash\n# Deploy a fleet\ncarrier deploy <fleet-id> \"<your request>\"\n\n# Approve pending tasks\ncarrier approve [deployed-id]\n\n# Monitor active deployments\ncarrier monitor [deployed-id]\n\n# Check deployment status\ncarrier status [deployed-id]\n```\n\n## 🏗️ Architecture\n\n### Object Model\n\n- **Agent**: Markdown file containing AI agent prompt\n- **Fleet**: Workflow template with task definitions and routing\n- **DeployedFleet**: Active workflow instance with isolated execution\n- **Task**: Work unit with inputs, outputs, and conditional routing\n\n### Execution Flow\n\n```\nUser Request → Fleet → Tasks → Subagents → Outputs → Routing → Completion\n```\n\n### Directory Structure\n\n```\ncarrier/\n├── src/                      # Source code\n│   ├── cli.ts               # CLI entry point\n│   ├── core.ts              # Core orchestration engine\n│   ├── cli-commands.ts      # Command implementations\n│   └── command-registry.ts  # Command definitions\n├── seed/                     # System templates\n│   ├── agents/              # Default agents\n│   └── fleets/              # Default fleets\n├── .carrier/                 # Runtime state (created on init)\n│   ├── config.json          # Configuration\n│   ├── fleets/              # Fleet templates\n│   └── deployed/            # Active deployments\n├── tests/                    # Test suite\n├── docs/                     # Documentation\n└── package.json             # Project configuration\n```\n\n## 🛠️ Development\n\n### Setup\n\n```bash\n# Install dependencies\nbun install\n\n# Development mode\nbun run dev\n\n# Type checking\nbun run lint\n\n# Run tests\nbun test\n```\n\n### Building\n\n```bash\n# Production build\nbun run build\n\n# Development build with watch\nbun run dev\n```\n\n### Testing\n\n```bash\n# Run all tests\nbun test\n\n# Run specific test suite\nbun test tests/unit/\nbun test tests/integration/\n\n# Watch mode\nbun run test:watch\n```\n\n## 📚 Commands Reference\n\n| Command | Description |\n|---------|-------------|\n| **Authentication** | |\n| `carrier auth` | Authenticate with GitHub OAuth |\n| `carrier whoami` | Show current user |\n| `carrier logout` | Logout from API |\n| **Fleet Management** | |\n| `carrier ls [--remote\\|--testing]` | List available fleets |\n| `carrier push <fleet-id> [--testing]` | Push fleet to remote/local |\n| `carrier pull <fleet-id> [--testing]` | Pull fleet from remote/local |\n| `carrier rm <fleet-id> [--remote\\|--testing]` | Remove fleet |\n| **Deployment** | |\n| `carrier deploy <fleet-id> <request>` | Deploy fleet with request |\n| `carrier approve [deployed-id]` | Approve pending task |\n| `carrier status [deployed-id]` | View deployment status |\n| `carrier monitor [deployed-id]` | Monitor active execution |\n| **System** | |\n| `carrier init [--global] [--no-claude]` | Initialize Carrier |\n| `carrier config` | Show configuration |\n| `carrier uninstall [--global] [--all]` | Uninstall Carrier |\n| `carrier help [command]` | Show help |\n\n### Command Flags\n\n- **init**: `--global`, `--no-claude`, `--dev`\n- **ls**: `--remote`, `--testing`\n- **push/pull**: `--testing`\n- **rm**: `--remote`, `--testing`\n- **status**: `--verbose`, `--json`\n- **config**: `--json`\n- **uninstall**: `--global`, `--all`, `--force`\n\n## 🌐 API Integration\n\n- **Production API**: https://carrier.sh/api\n- **API Documentation**: https://carrier.sh/api/openapi.json\n- **Authentication**: OAuth 2.0 with GitHub\n- **Local Development**: Configure `.env` for local API testing\n\n## 🔧 Configuration\n\n### Environment Variables\n\nCreate `.env` for local development:\n\n```env\n# Local API endpoint\nCARRIER_API_URL=http://localhost:3000/api\n\n# Callback port (default: 8123)\nCARRIER_CALLBACK_PORT=8124\n\n# Debug logging\nCARRIER_DEBUG=true\n```\n\n### Runtime Configuration\n\nLocated at `.carrier/config.json` after initialization.\n\n## 🤝 Contributing\n\n1. Fork the repository\n2. Create a feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n### Development Guidelines\n\n- Follow TypeScript best practices\n- Add tests for new features\n- Update documentation as needed\n- Use conventional commits\n- Ensure all tests pass\n\n## 📄 License\n\nThis project is licensed under the GNU Affero General Public License v3.0 or later. See the [LICENSE](LICENSE) file for details.\n\n## 🆘 Support\n\n- **Documentation**: [docs/](./docs/)\n- **Issues**: [GitHub Issues](https://github.com/carrier-sh/carrier/issues)\n- **API Reference**: https://carrier.sh/api/openapi.json\n\n## 🙏 Acknowledgments\n\n- Built with [Bun](https://bun.sh) runtime\n- Powered by [Claude Code](https://claude.ai/code) integration\n- Inspired by modern DevOps orchestration patterns","readmeFilename":"README.md","_rev":"1-8ca73c88ef5843906cd5e907b7e98677"}