{"id":49767488,"url":"https://github.com/michaelasper/arise","last_synced_at":"2026-05-11T11:03:45.653Z","repository":{"id":350772645,"uuid":"1203340736","full_name":"michaelasper/arise","owner":"michaelasper","description":null,"archived":false,"fork":false,"pushed_at":"2026-04-12T02:46:11.000Z","size":2834,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-12T03:09:25.180Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/michaelasper.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-07T00:35:49.000Z","updated_at":"2026-04-12T02:46:15.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/michaelasper/arise","commit_stats":null,"previous_names":["michaelasper/arise"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/michaelasper/arise","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelasper%2Farise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelasper%2Farise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelasper%2Farise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelasper%2Farise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/michaelasper","download_url":"https://codeload.github.com/michaelasper/arise/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/michaelasper%2Farise/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32891967,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-10T13:40:02.631Z","status":"online","status_checked_at":"2026-05-11T02:00:05.975Z","response_time":120,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-11T11:03:44.708Z","updated_at":"2026-05-11T11:03:45.647Z","avatar_url":"https://github.com/michaelasper.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Arise\n\n[![CI](https://github.com/michaelasper/arise/actions/workflows/ci.yml/badge.svg)](https://github.com/michaelasper/arise/actions/workflows/ci.yml)\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)\n\nArise is a Git-native orchestration engine for CLI coding agents. It turns serious software work into strict PRDs, reviewable YAML plans, isolated Git worktrees, durable run state, and recovery artifacts you can inspect after the model has stopped talking.\n\nThe pitch is simple: agent work should leave a trail. Arise gives you the trail.\n\nUse it when you want coding agents to work from a real plan, touch the repo in isolated task worktrees, checkpoint completed phases, and leave enough evidence on disk for a human or a fresh agent to understand what happened next week.\n\nArise is local-first tooling. Install it once, point it at a repository, and use the `arise` binary from your normal shell. The first supported execution provider is the Codex CLI.\n\n## Why Arise\n\nModern coding agents can move fast. That speed is only useful when the work is reviewable, resumable, and safe to integrate.\n\nArise is built around a few hard opinions:\n\n- **Start from written intent.** Use a strict PRD, GitHub issue PRD, roadmap slice, existing YAML plan, or explicit supervisor goal.\n- **Plan before mutation.** Generate a typed execution plan that can be reviewed before work starts.\n- **Isolate task work.** Run tasks in Git worktrees instead of letting every agent write into the same checkout at once.\n- **Persist the evidence.** Store plans, events, attempts, failures, gates, and recovery bundles under `.arise/`.\n- **Recover from reality.** Inspect, cancel, resume, replay, or repair local runs without reconstructing the story from chat logs.\n\n## What Works Today\n\nArise already supports the core local orchestration loop:\n\n- `init`: write the default project config.\n- `doctor`: check Git, Codex, Rust, workspace, and provider readiness.\n- `start --prd`: validate a strict local PRD, generate a YAML plan, save review artifacts, and optionally execute.\n- `start --github-issue`: fetch a GitHub issue body as a strict PRD source, snapshot metadata, generate a plan, and optionally execute.\n- `supervise`: generate a plan from an explicit goal.\n- `roadmap inspect`, `roadmap plan`, `roadmap sessions`, and `roadmap resume`: work from `docs/roadmap.md`.\n- `run`: execute a hand-authored or generated YAML plan.\n- `live`, `history`, and `export`: inspect persisted local run state.\n- `cancel`, `resume`, `replay`, and `recover`: handle interrupted, blocked, or stale runs.\n- `dashboard serve` and `editor plan`: early local surfaces over the same persisted artifacts.\n- `completions`: print shell completion scripts.\n\nNot first-class yet:\n\n- fully autonomous backlog management\n- GitHub issue comments, labels, milestones, assignees, linked PRs, or writeback\n- production support promises for providers beyond the Codex CLI adapter\n\n## Install\n\nUse a release binary unless you are contributing to Arise or intentionally building from source. Rust is required for Cargo installs, source checkouts, and workspace verification; it is not required to run the packaged release binary.\n\nPrerequisites for normal use:\n\n- Git.\n- Codex CLI on your `PATH`, or a matching provider entry in [`arise.yaml`](./arise.yaml), for planning and execution.\n- A Git checkout with at least one commit before non-dry-run task execution, because Arise creates Git worktrees for tasks.\n\nInstall the latest release with the shell script on macOS or Linux:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/michaelasper/arise/main/scripts/install.sh | bash\n```\n\nThe macOS/Linux script installs to `$HOME/.local/bin/arise` by default. Use `--install-dir` to choose another directory:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/michaelasper/arise/main/scripts/install.sh | bash -s -- --install-dir \"$HOME/bin\"\n```\n\nInstall the latest release with PowerShell on Windows:\n\n```powershell\nirm https://raw.githubusercontent.com/michaelasper/arise/main/scripts/install.ps1 | iex\n```\n\nThe Windows script installs to `$HOME\\.arise\\bin\\arise.exe` by default.\n\nInstall the latest release with Homebrew:\n\n```bash\nbrew install michaelasper/arise/arise\n```\n\nInstall the latest source with Cargo:\n\n```bash\ncargo install --git https://github.com/michaelasper/arise arise-cli --locked\n```\n\nRelease archives are published for:\n\n- `aarch64-apple-darwin`\n- `x86_64-apple-darwin`\n- `aarch64-unknown-linux-gnu`\n- `x86_64-unknown-linux-gnu`\n- `aarch64-pc-windows-msvc`\n- `x86_64-pc-windows-msvc`\n\nVerify the installed binary:\n\n```bash\narise --version\narise doctor\n```\n\nInstall or roll back to a specific GitHub release:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/michaelasper/arise/main/scripts/install.sh | bash -s -- --version v0.1.2\n```\n\nInstall a specific release with Cargo:\n\n```bash\ncargo install --git https://github.com/michaelasper/arise --tag v0.1.2 arise-cli --locked --force\n```\n\nUpgrade through the same channel you used to install:\n\nmacOS or Linux release script:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/michaelasper/arise/main/scripts/install.sh | bash\n```\n\nHomebrew:\n\n```bash\nbrew update\nbrew upgrade michaelasper/arise/arise\n```\n\nCargo:\n\n```bash\ncargo install --git https://github.com/michaelasper/arise arise-cli --locked --force\n```\n\nBefore upgrading across a major version, finish or cancel active runs unless the release notes explicitly say the old `.arise/` state is compatible. After every upgrade, run `arise --version` and `arise doctor` in the repositories where you use Arise.\n\nFor the full setup and upgrade procedure, read [How to Install and Upgrade Arise](./docs/guides/how-to-install-and-upgrade.md).\n\n## Agent Skill\n\nArise also publishes a `using-arise` skill for agents that support the `npx skills` ecosystem.\n\nInstall the latest repo-backed skill:\n\n```bash\nnpx skills add michaelasper/arise --skill using-arise -a codex -y\n```\n\nInstall a pinned released skill from a tag:\n\n```bash\nnpx skills add https://github.com/michaelasper/arise/tree/using-arise-vX.Y.Z/skills/using-arise -a codex -y\n```\n\nThe skill teaches review-first Arise usage: `doctor`, PRD planning with `--dry-run --no-auto-run`, `.arise/` artifact review, and the correct use of `recover inspect`, `resume`, and `replay`.\n\n## Releases\n\nReleases are automated from `main`. The release workflow plans the next SemVer tag from commit history, updates the Cargo workspace version, builds provenance-attested archives for every supported target, publishes the GitHub Release, verifies Cargo install from the release tag, updates the Homebrew tap, and smoke-tests `arise --version`.\n\nRelease-significant commits follow Conventional Commit meaning:\n\n- `feat:` creates a minor release.\n- `fix:`, `perf:`, `refactor:`, and `security:` create patch releases.\n- `!` or `BREAKING CHANGE` creates a major release.\n\nThe workflow also understands the repository's bracketed maintenance prefixes for compatibility. Configure either `HOMEBREW_TAP_TOKEN` or `RELEASE_TOKEN`; set `HOMEBREW_TAP` and `HOMEBREW_TAP_REPOSITORY` if the tap differs from `michaelasper/arise` and `michaelasper/homebrew-arise`. If `CARGO_REGISTRY_TOKEN` is configured, the workflow also publishes the available `arise-cli` package to crates.io.\n\n## Quickstart\n\nInitialize local Arise config:\n\n```bash\narise init\n```\n\nGenerate your first reviewable plan from the example PRD:\n\n```bash\narise start --prd examples/prd/bootstrap.md --dry-run --no-auto-run\n```\n\n`--dry-run --no-auto-run` keeps task execution off. Planning still writes local review artifacts under `.arise/` and promotes the generated YAML to `.arise/plans/\u003cplan-slug\u003e/generated-plan.arise.yaml` so you can inspect exactly what would run.\n\nRun the deterministic verification lane:\n\n```bash\ncargo fmt --all --check\ncargo clippy --workspace --all-targets --all-features -- -D warnings\ncargo test --workspace\ncargo test --doc --workspace\n```\n\nIf you use `just`, the same lane is:\n\n```bash\njust verify\n```\n\n## Core Workflow\n\nArise turns intent into artifacts:\n\n```text\nstrict PRD or issue\n        |\n        v\ngenerated execution plan\n        |\n        v\nhuman review and approval\n        |\n        v\ntask worktrees + verification gates\n        |\n        v\ncheckpointed phases + durable run history\n```\n\nPlan from a strict local PRD:\n\n```bash\narise start --prd examples/prd/bootstrap.md --dry-run --no-auto-run\n```\n\nPlan from a GitHub issue whose body is already a strict PRD:\n\n```bash\narise start --github-issue michaelasper/arise#123 --dry-run --no-auto-run\n```\n\nRun an existing plan:\n\n```bash\narise run .arise/plans/my-plan/generated-plan.arise.yaml\n```\n\nInspect and recover runs:\n\n```bash\narise live\narise history --limit 10\narise recover inspect \u003crun-id\u003e\narise resume \u003crun-id\u003e\narise replay \u003crun-id\u003e\n```\n\nUse `--yolo` only when you intentionally want dangerous unsandboxed worker execution.\n\n## Runtime Artifacts\n\nArise writes local runtime state under `.arise/`, which is ignored by Git.\n\nImportant paths:\n\n- [`arise.yaml`](./arise.yaml): project defaults.\n- `.arise/state.db`: SQLite run and task state.\n- `.arise/events.ndjson`: append-only event stream.\n- `.arise/plans/\u003cplan-slug\u003e/generated-plan.arise.yaml`: latest generated YAML plan for the plan slug.\n- `.arise/plans/\u003cplan-slug\u003e/revisions/rev-\u003cn\u003e/`: saved planning revision bundles.\n- `.arise/runs/\u003crun-id\u003e/`: run artifacts and task output files.\n- `.arise/runs/\u003crun-id\u003e/\u003ctask-id\u003e/attempt-\u003cn\u003e/`: per-attempt recovery bundles.\n- `.arise/runs/\u003crun-id\u003e/phase-\u003cn\u003e/integration/`: blocked checkpoint recovery bundles.\n- `.arise/runs/\u003crun-id\u003e/phase-\u003cn\u003e/checkpoint/`: successful checkpoint provenance bundles.\n- `.arise/worktrees/`: active or preserved task worktrees.\n- `.arise/sessions/`: saved roadmap planning sessions.\n\nThese artifacts can include prompts, provider output, command logs, file paths, local repo details, and private issue content. Review generated plans and `.arise/` bundles before sharing logs, exports, or issue-backed plans.\n\n## Learn Arise\n\nStart with the public guide pack:\n\n- [Install and Upgrade Arise](./docs/guides/how-to-install-and-upgrade.md)\n- [Getting Started Tutorial](./docs/guides/tutorial-getting-started.md)\n- [Plan From a PRD or GitHub Issue](./docs/guides/how-to-plan-from-prd.md)\n- [Inspect and Recover Runs](./docs/guides/how-to-inspect-and-recover-runs.md)\n- [Core Concepts Guide](./docs/guides/guide-core-concepts.md)\n- [Contributor Onboarding](./docs/guides/onboarding-contributors.md)\n\nDeeper references:\n\n- [Guides Index](./docs/guides/README.md)\n- [Development Guide](./docs/development.md)\n- [Strict PRD Workflow](./docs/prd-workflow.md)\n- [Roadmap](./docs/roadmap.md)\n- [PRD Index](./docs/prds/README.md)\n- [Terminal UX Roadmap](./docs/terminal-ux-roadmap.md)\n- [Commit Message Policy](./docs/commit-message-policy.md)\n- [ADR 0001: Unified Hybrid Core](./docs/adr/0001-unified-hybrid-core.md)\n\n## Project Layout\n\n- `crates/arise-core`: typed config, plan, PRD, roadmap, provider, and state models.\n- `crates/arise-engine`: scheduler, state store, Git helpers, coordination, and orchestration runtime.\n- `crates/arise-provider-codex`: Codex CLI provider adapter.\n- `crates/arise-provider-openai-compatible`: OpenAI-compatible planning provider adapter.\n- `crates/arise-provider-rig-worker`: experimental Rig worker provider scaffold.\n- `crates/arise-mcp`: MCP resource projections and guarded local controls.\n- `crates/arise-cli`: CLI commands, planning flows, roadmap sessions, dashboard API, and terminal output.\n- `examples/`: example PRDs and plans.\n- `docs/`: guides, roadmap, ADRs, PRDs, implementation plans, and development notes.\n\n## Contributing And Security\n\nRead [CONTRIBUTING.md](./CONTRIBUTING.md) before opening a pull request. It documents setup, verification expectations, commit style, and public-tree hygiene.\n\nReport vulnerabilities through [SECURITY.md](./SECURITY.md). Do not open public issues for security-sensitive reports.\n\nArise is released under the [MIT License](./LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelasper%2Farise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmichaelasper%2Farise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmichaelasper%2Farise/lists"}