Welcome to The Shift Platform
The Shift Platform is a Bun/TypeScript monorepo providing infrastructure tooling for AI coding agents. It gives both developers and AI agents a unified set of services for building, deploying, and operating software -- from service registration and identity management to usage telemetry and live previews.
Services share conventions (output triple, exit codes, pluggable storage, ID-or-name resolution) but run independently. A Hono-based gateway mounts most service APIs in-process on a single port, so consumers only need one endpoint.
Platform Services
The Shift Platform consists of 10 services, each focused on a single responsibility:
| Service | Purpose |
|---|---|
| Yellow Pages | Service catalog -- register, discover, and query services |
| Passport | Identity and access management for services and users |
| Pulse | Usage telemetry -- track events and generate reports |
| Ledger | Audit log for changes across the platform |
| Stage | Sandboxed React runtime -- deploy and preview apps live |
| Palette | Design tokens and theming for platform UIs |
| Communication | Messaging and notifications between services |
| Inference | LLM inference routing and configuration |
| Git | Git operations and repository management |
| Billing | Usage metering and billing integration |
Every service exposes a CLI, an HTTP API, and (for most) a web UI. The CLI supports three output modes -- human-readable, JSON (for agents), and quiet (exit codes only) -- so both humans and AI agents can consume it equally well.
Where to Go Next
- Quickstart -- Get the platform running locally in under 5 minutes
- Architecture Overview -- Understand the gateway, storage backends, and service topology
- CLI Reference -- Full command reference for the standalone
shift-clibinary - First App Tutorial -- Register a service, track an event, and deploy a preview in 10 minutes