Morpheus is agent operations for teams running AI work on real GitLab repositories. It turns a ready issue into an isolated, reviewable agent run, records evidence, updates a Draft merge request, and leaves the merge decision to a human.
Status: alpha.
Morpheus is an operator-facing control plane for a bounded software-delivery flow. It connects issue intake, agent execution, independent review, and merge-request evidence without treating an autonomous run as permission to merge.
It operates against one configured target repository and stores its runtime artifacts locally under .morpheus/.
- Agent work on production repositories needs a visible lifecycle, not an opaque background run.
- An implementation result needs independent review and concise evidence before a human decides whether to merge it.
- Authentication, repository state, unresolved decisions, and failed verification should stop work visibly rather than becoming implicit risk.
Morpheus never auto-merges.
- A GitLab issue receives the configured ready label, usually
agent:ready. - Morpheus validates the Agent-Ready Contract and prepares an isolated workspace.
- An agent implements the bounded work item.
- An independent review evaluates the result.
- Morpheus updates the Draft merge request with curated evidence.
- A human reviews and merges, or resolves the visible blocker.
- Git
- authenticated
glab - Docker-compatible runtime
- Beads (
bd) in the target repository - Codex CLI for ChatGPT subscription authentication
curl -fsSL https://github.com/NickSuomi/morpheus/releases/latest/download/install.sh | sh
morpheus --versioncd /path/to/target-repo
morpheus setup
morpheus doctor
morpheus daemon --oncemorpheus setup configures GitLab, the container runtime, and agent authentication. morpheus doctor checks the active target and prints recovery steps.
morpheus status # current lanes and failures
morpheus slice <issue-id> # full issue story
morpheus runs # run history
morpheus run <run-id> # one run
morpheus logs <run-id> # local transcript
morpheus sync # reconcile GitLab intakeMorpheus keeps deterministic decisions separate from effectful runtime work:
packages/coreowns pure state, scheduling, and contract decisions.packages/runtimeowns Effect-based use cases and service contracts.packages/adaptersmaps GitLab, Beads, SQLite, processes, and workspaces to those contracts.packages/clirenders commands without duplicating workflow logic.
The run ledger combines a mutable current summary with an immutable ordered event trail. Read the architecture and architecture decisions for the full contract.
- Morpheus is alpha; workflow and integration interfaces may change.
- ChatGPT-subscription authentication is serialized within one Morpheus process in the current alpha.
- A target repository needs the declared GitLab, Beads, container, and Codex prerequisites before side effects begin.
pnpm install
pnpm checkFor an installed target, run:
morpheus doctorMorpheus is licensed under Apache-2.0. See NOTICE for attribution.