[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-83136":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":9,"htmlUrl":8,"language":10,"languages":8,"totalLinesOfCode":8,"stars":11,"forks":12,"watchers":13,"openIssues":14,"contributorsCount":15,"subscribersCount":15,"size":15,"stars1d":16,"stars7d":17,"stars30d":17,"stars90d":15,"forks30d":15,"starsTrendScore":18,"compositeScore":19,"rankGlobal":8,"rankLanguage":8,"license":20,"archived":21,"fork":21,"defaultBranch":22,"hasWiki":21,"hasPages":21,"topics":23,"createdAt":8,"pushedAt":8,"updatedAt":24,"readmeContent":25,"aiSummary":26,"trendingCount":15,"starSnapshotCount":15,"syncStatus":27,"lastSyncTime":28,"discoverSource":29},83136,"devos.ing","0xroylee\u002Fdevos.ing","0xroylee",null,"https:\u002F\u002Fdevos.ing","TypeScript",104,1,55,5,0,15,49,45,0.9,"MIT License",false,"main",[],"2026-06-12 02:04:31","# devos.ing\n\nTalk is cheap, show me your agent system.\n\n[Quickstart](#quickstart) | [Operator Guide](docs\u002FNON_TECHNICAL_GUIDE.md) | [Architecture](ARCHITECTURE.md) | [CLI Reference](packages\u002Fcli\u002FREADME.md) | [Security](docs\u002FSECURITY.md)\n\n[![MIT License](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Flicense-MIT-green.svg)](LICENSE)\n[![Bun](https:\u002F\u002Fimg.shields.io\u002Fbadge\u002Fruntime-Bun-black.svg)](https:\u002F\u002Fbun.sh)\n\n# devos.ing is the local control plane for agentic development.\n\nOpen-source orchestration for coding agents, workflow daemons, task intake, and\noperator review.\n\n**If a coding agent is a worker, devos.ing is the workbench.**\n\ndevos.ing turns product and engineering requests into repeatable agent runs that\ncan brainstorm, plan, implement, review, test, and report progress across one or\nmore projects while keeping a human operator in control.\n\nIt looks like a CLI and local web UI. Under the hood: project routing, workflow\nstate, agent adapters, task intake, skills, run leases, review loops, secrets,\nand a daemon that keeps the system alive.\n\n**Manage agent work, not terminal chaos.**\n\n| Step | Example |\n| --- | --- |\n| **01** Define the request | \"Add retry handling for flaky API calls.\" |\n| **02** Route the work | Pick the project, repo, branch, skills, and agent runtime. |\n| **03** Run the workflow | Brainstorm, plan, implement, test, and review with checkpoints. |\n| **04** Inspect the outcome | Read logs, run state, PR context, blockers, and verification evidence. |\n\nWorks with Codex, Claude Code, Cursor Agent, GitHub, Linear, local web apps,\nscheduled jobs, and adapter-backed runtimes. If it can be invoked through a\nstructured adapter, devos.ing can coordinate it.\n\n## devos.ing is right for you if\n\n- You coordinate coding agents across more than one repo or project.\n- You want agent runs to start from project context instead of fresh terminal\n  improvisation.\n- You want a default workflow from brainstorm to plan, implementation, testing,\n  and review.\n- You need run state, logs, leases, errors, and PR context to survive restarts.\n- You want browser-driven commands and chat workflows backed by the same worker\n  path as CLI runs.\n- You want local-first secrets and config, with operator review points instead\n  of unattended mystery changes.\n- You want scheduled or polling agent work without rebuilding orchestration in\n  each repository.\n\n## Features\n\n### Bring Your Own Agent\n\nUse Codex, Claude Code, Cursor Agent, or another runtime through adapter\nboundaries. Workflow logic stays separate from the agent that executes a phase.\n\n### Project-Aware Routing\n\nProjects bind workspace paths, repository details, task sources, skills, agent\nbackends, and workflow defaults so commands do not need project-specific flags.\n\n### Workflow Pipeline\n\nThe default workflow moves work through `brainstorm`, `plan`, `implement`,\n`testing`, and `githubComment`, with retry and blocked states where they belong.\n\n### Run State And Leases\n\nPer-project state tracks current phase, agent sessions, chat logs, errors,\nleases, and progress under `.devos\u002Fprojects\u002F\u003Cproject-id>\u002F`.\n\n### Local Web UI\n\nThe browser UI talks to the server and workflow worker through the same command\npath operators use locally, so chat workflows and button-driven actions are\nauditable.\n\n### Production-Style Daemon\n\n`devos daemon` runs the server, web UI, worker, and poller together after build\nartifacts exist, making local automation feel like the real deployment shape.\n\n### Task Intake\n\nLoose requests can become structured backlog issues through the configured\nintake flow, including clarification rounds when requirements are still unclear.\n\n### Skills And Plugins\n\nSkills and plugin templates give agents reusable process knowledge and local\ntooling without hard-coding one project's workflow into the platform.\n\n## Problems devos.ing solves\n\n| Without devos.ing | With devos.ing |\n| --- | --- |\n| You have several agent terminals open and lose track of who is doing what. | Runs are attached to issues, projects, phases, logs, and durable state. |\n| Every repo needs its own fragile scripts and handoff rules. | Workflow behavior stays project-agnostic while project config supplies routing. |\n| Agents restart without the context that made the work meaningful. | Run state, task context, skills, and phase history travel with the workflow. |\n| Planning, implementation, review, and testing happen as ad hoc prompts. | The default workflow gives each phase a clear purpose and checkpoint. |\n| Browser commands and CLI commands drift into separate systems. | The web UI, server, worker, daemon, and CLI share the same orchestration path. |\n| Secrets and local config leak into prompts or repo files. | Onboarding stores secrets and trusted instance config under `~\u002F.devos\u002Fconfig`. |\n| Polling and scheduled work need custom glue. | The poller, cron runner, leases, and daemon provide a repeatable automation loop. |\n\n## Why devos.ing is special\n\ndevos.ing handles the hard orchestration details that are easy to underbuild.\n\n| System detail | Why it matters |\n| --- | --- |\n| **Project-agnostic workflows** | One platform can coordinate many repos without coupling logic to a single workspace. |\n| **Structured agent adapters** | Runtimes can change without rewriting the workflow pipeline. |\n| **Persistent run state** | Operators can inspect, resume, retry, or debug runs after restarts. |\n| **Human checkpoints** | Blocked work pauses for review instead of pretending uncertainty is success. |\n| **Shared CLI and web path** | Browser actions stay tied to the same worker and logs as terminal commands. |\n| **Local-first config** | Secrets and instance settings stay on the machine unless a run explicitly needs them. |\n| **Bun-only monorepo tooling** | Package management, scripts, tests, and workspace filters stay consistent. |\n\n## What's under the hood\n\ndevos.ing is a control plane, not a prompt wrapper.\n\n```mermaid\nflowchart TD\n    trigger[\"Operator, chat, poller, cron, or API\"] --> config[\"Config resolver\"]\n    config --> orchestrator[\"Workflow orchestrator\"]\n    orchestrator \u003C--> state[\"Run state and leases\"]\n    orchestrator \u003C--> taskSource[\"Task source\"]\n    orchestrator --> brainstorm[\"Brainstorm\"]\n    brainstorm --> plan[\"Plan\"]\n    plan --> implement[\"Implement\"]\n    implement --> review[\"Testing and review\"]\n    review --> decision{\"Pass?\"}\n    decision -->|yes| done[\"Done or PR ready\"]\n    decision -->|retryable bugs| implement\n    decision -->|blocked| human[\"Human review\"]\n    orchestrator --> adapter[\"Agent adapter\"]\n    adapter --> runtime[\"Codex, Claude Code, Cursor Agent\"]\n    orchestrator --> github[\"GitHub\"]\n    orchestrator --> linear[\"Linear or task board\"]\n    orchestrator --> notify[\"Notifications\"]\n```\n\n### The Systems\n\n**CLI and onboarding** - Parses commands, guides local setup, validates tools,\nstores secrets, resolves config, and starts workflow runs.\n\n**Server and realtime API** - Owns HTTP routes, readiness, workflow websocket\nbehavior, cron runtime, daemon bridge, repositories, and API tests.\n\n**Workflow worker** - Connects to the server, receives workflow commands, runs\nagent phases, and streams progress back to operators.\n\n**Agent adapters** - Normalize Codex, Claude Code, Cursor Agent, and other\nruntime outputs behind structured command arguments.\n\n**Database package** - Owns shared schema, migrations, helpers, seed scripts,\nbackup, and local instance data.\n\n**Web UI** - Gives operators a local dashboard for projects, sessions, chat,\nsettings, realtime events, and browser-driven workflow actions.\n\n**Landing and installer** - Serves the public landing site and hosted CLI\ninstaller at `https:\u002F\u002Fdevos.ing\u002Fcli`.\n\n**Skills and plugins** - Provide reusable agent process knowledge and bundled\nplugin templates for local tool installation and validation.\n\n## What devos.ing is not\n\n| Not this | The difference |\n| --- | --- |\n| **Not a chatbot** | Chat is one interface, not the unit of work. Runs are tied to projects, phases, and evidence. |\n| **Not a single-agent wrapper** | devos.ing coordinates runtimes, task sources, config, state, and review across projects. |\n| **Not a hosted-only service** | The default path is local-first, with secrets and instance config stored on your machine. |\n| **Not a drag-and-drop workflow builder** | The pipeline is code-defined and project-agnostic, built for engineering work. |\n| **Not a replacement for review** | The platform keeps humans in control with checkpoints, logs, and explicit blockers. |\n\n## Quickstart\n\nInstall the published CLI with the hosted bash installer:\n\n```bash\ncurl -fsSL https:\u002F\u002Fdevos.ing\u002Fcli | bash\n```\n\nRun guided onboarding. The wizard writes local instance config and stores\nsecrets under `~\u002F.devos\u002Fconfig`.\n\n```bash\ndevos onboard\ndevos daemon\n```\n\nRun one scoped workflow:\n\n```bash\ndevos run --issue ENG-123\n```\n\nIf you want devos.ing to keep polling for eligible work:\n\n```bash\ndevos run --poll\ndevos run --poll-forever\n```\n\nRun `devos onboard --check` after any config change. It validates config,\ntooling, GitHub auth, agent runtime availability, and secret placement.\n\n## Prerequisites\n\nThe installer and onboarding flow handle as much setup as possible, but real\nworkflow runs need a few local tools and credentials:\n\n- Bun `>=1.3.0` for this monorepo and package scripts.\n- GitHub CLI authenticated with `gh auth login` when workflows touch GitHub.\n- RTK available for token-optimized agent shell execution.\n- At least one configured coding-agent runtime, such as Codex, Claude Code, or\n  Cursor Agent.\n- Project credentials and routing details for the systems you use, such as\n  Linear, GitHub, and optional Resend notifications.\n\n## Development\n\nClone the repo, install dependencies with Bun, build the local CLI package, and\nvalidate onboarding.\n\n```bash\nbun install\nbun run build\ndevos help\ndevos onboard\ndevos onboard --check\n```\n\nStart the local development stack:\n\n```bash\nbun run dev\n```\n\nThat command starts:\n\n- API server on `http:\u002F\u002Flocalhost:3001`.\n- Web UI on `http:\u002F\u002Flocalhost:3000`.\n- Workflow worker connected to `\u002Fapi\u002Fworkflow`.\n\nIf the web UI reports `No CLI worker connected to \u002Fapi\u002Fworkflow`, keep the\nserver running and start the worker:\n\n```bash\nbun run dev:worker\n```\n\nThe worker connects to `ws:\u002F\u002F127.0.0.1:3001\u002Fapi\u002Fworkflow` by default. Override\nthe local targets when needed:\n\n```bash\nDEVOS_SERVER_BASE_URL=http:\u002F\u002F127.0.0.1:3001\nDEVOS_WORKFLOW_WS_URL=ws:\u002F\u002F127.0.0.1:3001\u002Fapi\u002Fworkflow\n```\n\nTo run the full local development stack in Docker:\n\n```bash\ndocker compose up\n```\n\nThe Compose stack exposes the web UI at `http:\u002F\u002Flocalhost:3000`, the API server\nhealth endpoint at `http:\u002F\u002Flocalhost:3001\u002Fhealth`, the workflow worker connected\nto `ws:\u002F\u002Fserver:3001\u002Fapi\u002Fworkflow`, and the landing site at\n`http:\u002F\u002Flocalhost:3002`.\n\nStop it with:\n\n```bash\ndocker compose down\n```\n\n## Common Commands\n\n```bash\n# guided setup and validation\ndevos onboard\ndevos daemon\ndevos onboard --check\n\n# run one issue or the configured queue\ndevos run --issue ENG-123\ndevos run\n\n# poll continuously for work\ndevos run --poll\ndevos run --poll-forever\n\n# inspect run state\ndevos status --issue ENG-123\n\n# inspect GitHub releases and create a tag-only release marker\ndevos release list --limit 10\ndevos release tag v0.0.2 --message \"Release v0.0.2\"\n\n# create a task through the configured intake flow\ndevos task create --request \"Add retry handling for API timeouts\"\n```\n\nFor full command details, read [packages\u002Fcli\u002FREADME.md](packages\u002Fcli\u002FREADME.md).\n\n## Repository Map\n\n- `packages\u002Fcli\u002F`: CLI parsing, onboarding, config resolution, workflow\n  orchestration, daemon helpers, task intake, skills, and integrations.\n- `packages\u002Fserver\u002F`: HTTP API, realtime\u002Fwebsocket behavior, cron runtime,\n  workflow-data boundaries, repositories, and server tests.\n- `packages\u002Fweb\u002F`: Next.js operator UI, client data access, realtime state,\n  providers, components, and frontend tests.\n- `packages\u002Fdb\u002F`: Shared database schema, migrations, helpers, and DB scripts.\n- `packages\u002Flanding\u002F`: Public landing site and hosted CLI installer route.\n- `packages\u002Fagent-adapters\u002F`: Runtime adapters for Codex, Claude Code, Cursor\n  Agent, and normalized agent output contracts.\n- `packages\u002Fagents\u002F`: Shared agent\u002Fsession\u002Fguardrail primitives.\n- `packages\u002Fcreate-devos-plugin\u002F`: Plugin scaffolding package.\n- `packages\u002Fworkflow\u002F`: Workflow scaffolding\u002Fruntime package.\n\n## Quality Checks\n\nRun these before opening or updating a PR:\n\n```bash\nbun run check\nbun run typecheck\nbun test\n```\n\nUseful focused checks:\n\n```bash\nbun run --filter devos typecheck\nbun run --filter devos-server check\nbun run --filter devos-server typecheck\nbun run --filter devos-server test\nbun test packages\u002Fcli\u002Ftests\u002Fsmoke-flow.test.ts\n```\n\n## More Documentation\n\n- [docs\u002FNON_TECHNICAL_GUIDE.md](docs\u002FNON_TECHNICAL_GUIDE.md): operator-friendly\n  guide to the system and workflow.\n- [docs\u002Fworkspace-cli-commands.md](docs\u002Fworkspace-cli-commands.md): full CLI\n  command reference.\n- [docs\u002Fproduct-specs\u002Fnew-user-onboarding.md](docs\u002Fproduct-specs\u002Fnew-user-onboarding.md):\n  expected new-user onboarding flow.\n- [ARCHITECTURE.md](ARCHITECTURE.md): system boundaries and workflow model.\n- [docs\u002FRELIABILITY.md](docs\u002FRELIABILITY.md): reliability and run behavior.\n- [docs\u002FSECURITY.md](docs\u002FSECURITY.md): secrets and security expectations.\n- [docs\u002FPLANS.md](docs\u002FPLANS.md): active operating plans.\n- [docs\u002FQUALITY_SCORE.md](docs\u002FQUALITY_SCORE.md): quality posture.\n\n## Star History\n\n\u003Ca href=\"https:\u002F\u002Fwww.star-history.com\u002F?repos=0xroylee%2Fdevos.ing&type=date&legend=top-left\">\n \u003Cpicture>\n   \u003Csource media=\"(prefers-color-scheme: dark)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=0xroylee\u002Fdevos.ing&type=date&theme=dark&legend=top-left\" \u002F>\n   \u003Csource media=\"(prefers-color-scheme: light)\" srcset=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=0xroylee\u002Fdevos.ing&type=date&legend=top-left\" \u002F>\n   \u003Cimg alt=\"Star History Chart\" src=\"https:\u002F\u002Fapi.star-history.com\u002Fchart?repos=0xroylee\u002Fdevos.ing&type=date&legend=top-left\" \u002F>\n \u003C\u002Fpicture>\n\u003C\u002Fa>\n","devos.ing 是一个本地控制平面，用于管理和协调编码代理的工作流程。其核心功能包括项目感知路由、自定义工作流管道以及运行状态和租约管理，支持Codex、Claude Code等编码代理的接入，并通过结构化适配器实现跨多个项目的任务调度与执行。此外，该项目提供了一个从头脑风暴到计划、实施、测试和审查的默认工作流程，同时保持了人类操作员对整个过程的控制权。适用于需要在多个仓库或项目中协调编码代理工作、希望从项目上下文启动代理运行而非终端即兴操作、追求有默认工作流支持及持久化运行状态记录的场景。",2,"2026-06-11 04:10:14","CREATED_QUERY"]