Orion is an AI-native development environment manager for parallel coding agents. It combines Git worktrees, tmux sessions, and agent workflows into one local protocol.
- Parallel and isolated execution: each node has its own worktree, session, and branch context.
- Agent-first Git model: humans manage goals; agents handle branch-heavy routine operations.
- Human-as-manager workflow: enter any node at any time to inspect progress and redirect work.
- Local Agentic DevOps: run integration steps locally with agent pipelines, not only in remote CI.
- Attention routing: Orion can detect pending input in node sessions and notify you.
- Official Feishu/Lark support: route waiting-input events to team chat for faster human feedback loops.
This path covers your target loop: create node with AI, code, detach, switch to new work, return on notification, then push safely.
curl -fsSL https://raw.githubusercontent.com/markshao/orion/main/install.sh | bashThen initialize a workspace:
# create a workspace
orion init https://github.com/<you>/<repo>.git
cd <repo>_swarmorion ai "implement login API and session flow"
orion enter <node-name>Inside tmux, launch your coding agent and start vibe coding:
codex
# or
kimiDetach from tmux:
Ctrl+b, then d
orion ai "start payment retry feature"When Orion detects another node is waiting for your input, you'll receive notifications (including Feishu/Lark, if configured). You can also check watcher status:
orion notification-service status
orion notification-service list-watchersJump back to the waiting node:
orion enter <previous-node-name>orion workflow run release-workflow --node <node-name>
orion workflow ls
orion inspect <node-name>Then finish commit/rebase/push with the Codex skill:
/push_remote
/push_remote requires the push-remote skill to be installed in Codex.
Or use Orion native push directly:
orion push <node-name>| Command | Purpose |
|---|---|
orion init <repo-url> |
Initialize an Orion workspace |
orion ai "<task>" |
Create branch + node from natural language |
orion spawn <branch> <node> |
Manually create a node |
orion enter <node> |
Enter the node tmux session |
orion ls |
List active nodes |
orion inspect <node> |
Show node status and branch details |
orion workflow run <workflow> --node <node> |
Trigger an agent workflow |
orion workflow ls |
List workflow runs |
orion workflow inspect <run-id> |
Inspect workflow details |
orion notification-service status |
Show notification service status |
orion notification-service list-watchers |
Show watcher state and pending input |
orion push <node> |
Push node branch to remote |
- Concepts: Human Node, Agentic Node, Shadow Branch
- Workflows: Local Agentic DevOps and pipeline config
- Notifications: waiting-input detection and alerting
- Configuration: LLM, runtime, and workspace settings
- Architecture: workspace, git, tmux, workflow engine
- Installation Guide
- Human Node Guide
- Orion Skills (
push-remote)
Apache License 2.0