{"name":"Maka: A High-Performance Agent Workspace for AI Tasks","description":"Apache Maka (Incubating) is a high-performance agent workspace designed to maintain a complete, append-only record of all agent actions. It focuses on measurable performance, local-first operation, and robust recovery mechanisms. This project provides a unified execution authority for desktop, TUI, and CLI clients, ensuring consistent agent behavior across platforms.","github":"https://github.com/Maka-Agent/maka-agent","url":"https://osrepos.com/repo/maka-agent-maka-agent","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/maka-agent-maka-agent","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/maka-agent-maka-agent.md","json":"https://osrepos.com/repo/maka-agent-maka-agent.json","topics":["AI Agent","Agent Runtime","LLM","TypeScript","Desktop App","CLI Tool","Event Sourcing","Apache Project"],"keywords":["AI Agent","Agent Runtime","LLM","TypeScript","Desktop App","CLI Tool","Event Sourcing","Apache Project"],"stars":null,"summary":"Apache Maka (Incubating) is a high-performance agent workspace designed to maintain a complete, append-only record of all agent actions. It focuses on measurable performance, local-first operation, and robust recovery mechanisms. This project provides a unified execution authority for desktop, TUI, and CLI clients, ensuring consistent agent behavior across platforms.","content":"## Introduction\n\nApache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did. As an Apache Incubating project, Maka is built to help AI agents complete tasks efficiently and transparently. It emphasizes measurable performance, ensuring that every run is benchmarked and fully recorded.\n\nMaka operates on a few core principles: its performance is measured, not just claimed, with per-task results published. The entire runtime is based on an append-only log of `RuntimeEvent`s, which drives the UI, future prompts, and crash recovery. It supports a local-first approach, keeping sessions, settings, and run records on your machine, allowing you to bring your own model, whether it's a cloud API, a local model, or a compatible gateway. Furthermore, Maka provides a single `Runtime Host` that serves as the execution authority for its Desktop, TUI, CLI, and evaluation clients.\n\n## Why Use and Key Benefits\n\nMaka offers several compelling advantages for developers and researchers working with AI agents:\n\n*   **Measured, Not Claimed Performance**: Unlike many agent harnesses, Maka is rigorously benchmarked against others using the same model and official verifier. The per-task results are transparently published, providing concrete evidence of its efficiency and effectiveness.\n*   **The Log is the Runtime**: Every significant action, including model messages, tool calls, permission decisions, and terminations, is recorded as an append-only `RuntimeEvent`. This robust logging mechanism ensures that the UI, subsequent prompts, and crash recovery are all projections of this immutable log, enhancing reliability and auditability.\n*   **Your Machine, Your Model**: Maka is designed with a local-first philosophy. All sessions, settings, and run records remain on your local machine, ensuring data privacy and control. It offers flexibility in model integration, allowing users to connect to various models, including cloud APIs, local models, or compatible gateways.\n*   **One Runtime Host**: The project unifies its execution authority through a single `Runtime Host`. This means that whether you are using the Desktop application, the Terminal User Interface (TUI), the Command Line Interface (CLI), or the evaluation framework, they all leverage the same core execution logic, ensuring consistent and predictable agent behavior across different interfaces.\n\n## Installation\n\nTo get started with Apache Maka, you can build it directly from source. Here are the steps to set up and run the Desktop application:\n\n**Requirements:**\n\n*   Node.js 22.19 or newer (CI uses Node.js 24)\n*   npm (the lockfile and scripts use npm; the current `packageManager` is npm 11)\n*   Git\n*   `ripgrep`, used by Runtime's `Grep` tool\n\n**Start Desktop:**\n\nsh\ngit clone https://github.com/apache/maka.git\ncd maka\nnpm ci\nnpm run dev\n\n\n`npm run dev` starts the Desktop development environment with Hot Module Replacement (HMR). To build every workspace before starting Electron, use `npm run dev:full`.\n\n**First Run Configuration:**\n\nMaka does not bundle a shared model account. On first launch, you will need to:\n\n1.  Open `Settings ? Models`.\n2.  Add an API, local-model, or supported account connection.\n3.  Test it and choose a default model.\n4.  Return to the workspace and start a task.\n\n## Examples\n\nMaka provides powerful command-line tools for interacting with agents. After building the workspaces with `npm run build`, you can use the development CLI:\n\n**Start the TUI:**\n\nsh\nnpm run cli:dev\n\n\n**Run a specific task:**\n\nsh\nnpm run cli:dev -- run \"Summarize this repository and identify its most important risk\"\n\n\n**Run a task with graph visualization:**\n\nsh\nnpm run cli:dev -- run --graph \"Implement two independent slices, integrate them, then review the result\"\n\n\n## Links\n\n*   **Website**: [https://maka.apache.org/en/](https://maka.apache.org/en/)\n*   **Documentation**: [https://maka.apache.org/en/docs/](https://maka.apache.org/en/docs/)\n*   **GitHub Repository**: [https://github.com/apache/maka](https://github.com/apache/maka)","metrics":{"detailViews":3,"githubClicks":0},"dates":{"published":null,"modified":"2026-09-20T23:12:00.000Z"}}