Open Source  ·  MIT License

The Coding Agent Built for
Humans and Agents Alike

A terminal-native coding agent with a rich TUI for humans and a plain CLI that AI agents can invoke directly — two interfaces, one tool, zero friction.

$ curl -fsSL https://raw.githubusercontent.com/20ZollCoder/openmarv/main/install.sh | bash
openmarv — TUI mode
marv›refactor auth module to use JWT
● Reading src/auth/session.py…
● Reading src/auth/middleware.py…
● Analyzing 847 lines across 6 files
✓ Plan ready — 3 files to modify
src/auth/session.py +47 −23
src/auth/middleware.py +12 −8
tests/test_auth.py +31 −0
● Writing changes…
✓ Done. All tests passing (23/23)
marv›
MMIT License
TUI + CLI
Human + Agent Interfaces
Model Agnostic
Hermes & OpenClaw Ready
// why openmarv
// The Core Idea

Two interfaces.
One tool.

OpenMarv speaks two languages. Humans get a full interactive TUI — built for focus and flow. AI agents get a clean, scriptable CLI — built for automation and pipelines. Same coding engine underneath, zero configuration switching.

For Humans — TUI
openmarv
marv›refactor the payment module
● Reading src/payments/…
✓ Plan ready — 4 files
payments.py +52 −18
tests/test_pay.py +24 −0
✓ All 31 tests passing
marv›
same engine
openmarv
For Agents — CLI
hermes invokes openmarv
$openmarv run "refactor payments"
● Working on src/payments/…
✓ 4 files modified
$openmarv run "write tests" --json
✓ {"tests": 24, "pass": 24}
// Features

Everything a coding agent
should be.

TUI
Rich TUI for Humans

A beautiful, interactive terminal interface. Multi-line editing, syntax-aware diffs, streaming output, and session history — designed for developers who live in the terminal.

CLI
Agent-Native CLI

Agents get a clean, structured interface: parseable JSON output, non-interactive commands, stdin support. Built to be called by machines — no prompts, no noise.

Codebase-Aware

OpenMarv reads your project structure, understands file dependencies, and tracks what it has already changed — so every response is grounded in the actual state of your code.

Model Agnostic

OpenAI, Anthropic, Ollama, or any OpenAI-compatible endpoint. Switch models per-session without touching config files.

Session Persistence

Sessions survive reboots. Full context, file history, and conversation intact. Your work and your agent's work are never lost — pick up exactly where you left off.

Familiar by Design

If you've used Claude Code or OpenCode, you already know the mental model. Same file-aware coding experience — just with multi-agent superpowers layered on top.

// Integrations

Works with the agents
you already run.

OpenMarv's CLI is designed to be called by AI agents. Any agent that can run shell commands can invoke OpenMarv to handle coding tasks — no SDK, no custom integration required.

Hermes Agent
nousresearch.com

Hermes can invoke OpenMarv directly from its terminal to delegate complex coding tasks — refactors, test generation, debugging — and get structured results back.

# Hermes delegates to OpenMarv
$ openmarv run "refactor auth to JWT"
✓ Done. 3 files modified.
OpenClaw
openclaw.ai

OpenClaw skills can call OpenMarv for any coding task. Build a skill once and let Claw delegate implementation work to OpenMarv automatically.

# OpenClaw skill
$ openmarv run "write unit tests"
✓ 14 tests written. All passing.
Any Agent
shell interface

If it can run a shell command, it can use OpenMarv. The CLI is minimal, composable, and outputs structured JSON — easy to parse in any pipeline.

# Any shell-capable agent
$ openmarv run "<task>" --json
{"status": "done", "files": 3}
// Use Cases

Built for how teams
actually work now.

Use Case
Agents handle the boring parts

Set up OpenMarv in a project, tell Hermes to use it for test generation or refactoring. Your agent does the gruntwork via CLI while you focus on architecture in the TUI.

Use Case
Pipelines with structured output

The --json flag makes OpenMarv's output machine-readable. Wire it into any automation pipeline — agents get clean, parseable results from every coding task.

// Changelog

What's new.

latest
2026
Check GitHub for current releases

OpenMarv is under active development. See the releases page on GitHub for the full and up-to-date changelog.

// Get Started

Ready to code with
your whole team?

Install OpenMarv in one line. Give your agents a coding agent they can actually work with.

Tweaks
Accent Color
Subtle Background
Glow Effects