Steer by conversation
Describe the outcome you want, review the agent's proposed roadmap change, and decide what enters the ready queue.
Roadmap and workflow management for coding agents
Tell your agent where to take the roadmap, review the draft it produces, then carry one ready task through recorded work, checks, and evidence.
Magistr — terminal
Shape the roadmap, then ship with proof
Talk through the direction with your agent. Magistr carries the roadmap change you accept through focused work, configured checks, and a record you can resume.
Scaffolding
Auto-detects your stack and generates hooks, rules, and skills tailored to your project. One command to go from zero to a fully configured AI dev environment.
Recorded iteration
Each selected chunk follows a recorded research-plan-execute-verify cycle. Magistr runs the configured gates and creates one atomic commit before you choose the next iteration.
Terminal cockpit
The supported interactive terminal surface shows workflow phases, task progress, live output, and session controls while a run is active.
Roadmap Tracking
Tell your agent what direction to take. You review the draft, then Magistr keeps the accepted priorities, dependencies, acceptance, and follow-up work in the recorded project roadmap.
Source tools & MCP
Workbench provides verified search, reads, edits, undo, scripts, and declared commands; Magistr MCP exposes the workflow services that record plans and gates.
Desktop & peer protocol
Experimental surfaces: the desktop viewer lives on the gui2 branch, and the peer protocol is a compatibility API without production runtime wiring.
A shared model
See how Magistr fits your workflow
Four views answer the questions that matter when you start: how to steer the roadmap, which loop owns the work, what one iteration does, and what remains when you return.
Choose your loop
Use Codex or Claude when you want an agent-led session. Open the TUI when you want Magistr to own the interactive loop.
Ship one chunk
A ready item moves through research, planning, workspace changes, verified gates, and a recorded result.
Resume from state
Roadmap, reasoning, ship actions, checks, and project configuration stay connected for the next session.
Build Magistr from source
Build with Rust 1.95 or later. v0.1 is source-first while the public release pipeline is being established. See the installation guide and release inventory.
$
git clone https://github.com/AlrikOlson/magistr magistr From zero to shipping
Three commands. That's all it takes.
1
Initialize your project
Magistr detects your stack and generates agent configs — hooks, rules, skills, and project.json — tailored to your codebase.
terminal
$ magistr init
Detected: Rust (edition 2024) ✓ Generated .claude/rules/conventions.md ✓ Generated .claude/rules/workflow.md ✓ Created .magistr/project.json ✓ Native roadmap state stays in the project store (exports disabled)
2
Start your first iteration
Magistr reads native roadmap state, picks the next ready chunk, and runs one recorded research-plan-execute-verify cycle.
terminal
$ magistr next
Phase: research → plan → execute → verify ✓ Read native roadmap state — found the next ready chunk ✓ Planned 4 tasks for this iteration ✓ Implemented with TDD (3 tests green) ✓ Quality gates passed (check + test + lint) ✓ Committed: one atomic change for the selected chunk
3
Watch it work in the terminal cockpit
The supported terminal cockpit shows phase changes, task progress, live output, file changes, and session stats while the run is active.
terminal
$ magistr next-loop
┌─ Magistr ─────────────────────────────┐ │ Phase: execute ▓▓▓▓▓▓▓░░░ 70% │ │ Tasks: 3/4 complete │ │ Stream: writing auth middleware... │ │ Files: +3 ~2 │ └───────────────────────────────────┘
Join the community
Get help, share feedback, and contribute to Magistr.
GitHub
Star the repo, report issues, and browse the source code.
Issues
Report a bug or request a change.
Contributing
Read the public contributing guide and submit your first pull request.
Read the contributing guide, security policy, and code of conduct before opening a change or report.
What’s new
Latest releases and updates.
No published GitHub release is available yet. The current source tag is v0.1.0; watch the releases page for packaged assets.