Martty

Martty is an open-source terminal user interface (TUI) coding agent and session harness developed by openma-ai. It provides an interactive terminal workspace designed for running AI coding agents with direct access to local development repositories. In day-to-day workflows, Martty operates via an ACP-native (Agent Client Protocol) Cordis TUI runtime. It features an interactive composer dock that continuously tracks real-time token metrics (input, output, cached, and reasoning tokens) and visualizes context window consumption against supported LLMs, including 1.0M context architectures like DeepSeek-v4 variants down to standard 128K models. Users interact via prompt inputs, keyboard shortcuts, and built-in slash commands. Martty differentiates itself by maintaining a clean transcript scrollback through non-destructive popup dialogs for commands like `/help`, `/keys`, `/session`, and `/plugins`. Rather than dumping metadata into standard output, it renders tree-based plugin inventories (`tui-tree-widget`) and session status inspectors inside self-contained overlays. Martty is open-source software distributed via npm and GitHub repository releases, currently under active pre-1.0 development.

Tags: agent harness, cli, coding agent, OpenSource, terminal

Visit Martty

Key features

• ACP-Native TUI Runtime — Powered by an ACP-native Cordis runtime for orchestrating terminal agent sessions. - Context Window Gauge — Live composer dock displays input/output token usage and session capacity percentages against model limits (e.g., 1.0M context for DeepSeek models, 128K standard). - Clean Modal Dialogs — Non-destructive popup views for /help, /session, /keys, and plan viewing that keep the terminal scrollback uncluttered. - Plugin Inventory Tree — Interactive two-level provider-to-plugin browser using tui-tree-widget with folding, expanding, and keyboard navigation. - Queue & Composer Controls — Integrated controls to stage prompts, manage execution queues, and control agent turns in the terminal.

Use cases

Use Case: Large-Context Terminal Refactoring Developers working on multi-file codebases can run iterative refactoring sessions while monitoring real-time context window usage in the composer dock to prevent token exhaustion.

Use Case: Non-Destructive Session and Plugin Inspection Engineers can audit active provider plugins and manage authentication keys in modal overlay windows without dumping diagnostic text into their current code diff transcript.

Use Case: ACP-Compliant Local Agent Execution Developers running ACP-compatible workflows can execute local codebase tasks inside a lightweight, standalone terminal client without relying on heavyweight IDE extensions.

Who it is for

Martty is designed for terminal-centric developers and engineers who want an ACP-compatible TUI agent with granular token tracking and clean modal overlays. It is not suited for developers who require graphical web interfaces or tight integration exclusively inside GUI IDE sidebars.

Install guide

Installation Install Martty globally via npm: bash npm install -g martty Alternatively, clone and build from the source repository: bash git clone https://github.com/openma-ai/Martty.git cd Martty npm install npm run build

First Run Launch Martty from the root of your project directory: bash martty Open the modal configuration dialogs to verify your API keys and provider plugin status: text /keys /plugins

Example Session Enter your prompt into the composer dock to execute an agent task: text Analyze src/host/runtime.rs, identify unhandled error states, and add structured logging.

Part of CLI Coding Agents

Categories: AI Coding Agents, Code Assistants, Developer Tools

Related CLI agents

• amux — amux is an open-source agent harness and session multiplexer developed by Mixpeek. Built in Rust, it is designed to manage,…
• CLI Agent Orchestrator — CLI Agent Orchestrator (CAO) is an open-source agent orchestration harness maintained by AWS Labs (awslabs). It provides a structured CLI…
• ForgeCode — ForgeCode is an open-source terminal coding harness and multi-agent orchestrator developed by Tailcall. It integrates directly into the developer's shell…
• Pi Boss — Pi Boss is an open-source multi-agent orchestration extension developed by skyfallsin for the pi terminal coding agent ecosystem. It provides…
• gate4agent — gate4agent is an open-source Rust-based agent harness and runtime orchestrator developed by ZENG3LD. It serves as a supervisory control layer…
• OpenHarness — OpenHarness is an open-source terminal coding agent and execution harness developed by Zhijie Wong. Built as an open alternative designed…