Build with One Horizon
Developer docs are for software that needs to work with a workspace: AI assistants, terminal workflows, internal services, customer-facing apps, and event-driven automation.
Building from your own app or automation? Start with the job: read or update workspace data, connect an AI assistant, run terminal workflows, sign users in, or react to events. Already know the REST route or webhook event? Open the API reference.
Agent execution is a separate workflow. For sending work to apps, running local workers, or building agents that claim queued work, start with Agent workflows. Spec-driven development explains how initiatives and bugs become agent-ready work.
Pick the right surface
| Surface | Best for |
|---|---|
| MCP | Connect AI assistants to workspace context and tools. |
| CLI | Work from the terminal, inspect work, send items to coding tools, and run local Codex workers. |
| API Keys | Authenticate trusted server-side API and SDK calls for one workspace. |
| REST API | Read or update workspace data from your app, service, script, or CI job. |
| JavaScript SDK | Generated TypeScript clients and types for Node.js. |
| OAuth Apps | Add Log in with One Horizon or Connect One Horizon to an app that needs user-approved workspace access. |
| Webhooks | Notify a service when workspace events happen. |
Building an agent?
Start with Agent workflows. Agent docs cover sending work to an app, running local workers, and building local or cloud agents.
From there, choose Build a Local Agent for work that runs on your machine or Build a Cloud Agent for a shared service.