Local-first AI agent workspace and runtime · Apache Incubator project in active beta development

apache/maka

Apache-2.0, local-first AI agent workspace with Electron desktop, TUI/non-interactive CLI, a shared Runtime Host, built-in coding tools, sandbox approval boundaries, durable append-only execution records, crash recovery, optional MCP and computer-use integrations, and a reproducible evaluation subsystem; it is a standalone alternative or companion to Claude Code, not a documented Claude Code extension.

software developmentAI agentslocal-first applicationsdeveloper toolsagent evaluationdesktop applicationsterminal applicationsmodel orchestrationruntime infrastructurecomputer use
Routing score
80.0
Readiness
Developer and tester prerelease; explicitly not intended for production use
License
Apache-2.0
Maintenance
active
Components
20
Revision
0

Selection

Select when

  • You want a standalone local-first coding-agent workspace rather than a Claude Code extension.
  • You need both desktop and terminal interfaces over a shared agent runtime.
  • You want model and tool activity retained as a recoverable execution record.
  • You need bring-your-own cloud, local, or gateway model connections.
  • You want approval-gated filesystem, shell, and network-related agent operations.
  • You need session branching, retries, artifacts, search, and crash recovery.
  • You want optional MCP, web search, memory, computer use, or catalog skills.
  • You need declarative comparisons between Maka and external agent subjects.
  • You can accept beta software and changing commands or data formats.
  • Your supported environment matches the documented CLI or desktop platform matrix.

Boundaries

Avoid when

  • You require a native Claude Code plugin, hook, command, skill, or MCP server specifically for Claude Code.
  • You need a production-supported or approved ASF release.
  • You require a stable data format and command surface.
  • You need the desktop application on Linux or Intel macOS.
  • You require a signed and fully supported Windows desktop release.
  • You require credentials to be stored in an operating-system keychain.
  • You do not want to supply and configure a model provider or local model.
  • You cannot grant a Node-based agent workspace access to project files and optional shell execution.
  • You require every security-sensitive implementation claim to have been independently audited.
  • You need benchmark setup without Docker, pinned Python environments, or machine-local benchmark assets for Harbor or Pier.

Strengths

Capabilities

Provides an Electron and React desktop workspace with streaming sessions, tool timelines, branching, search, artifacts, and recovery.Provides an interactive TUI and a non-interactive CLI through the maka-agent npm package.Routes Desktop, terminal, and Maka evaluation execution through one Runtime Host.Records model messages, tool calls, tool results, permission decisions, termination outcomes, and usage as durable runtime facts.Supports multiple model connections through cloud APIs, local models, supported accounts, or compatible gateways.Includes Read, Write, Edit, Bash, Glob, and Grep tools in the agent runtime.Requires approval for tool operations that leave the configured sandbox unless the user selects an explicit bypass.Supports aborting runs, classifying failures, crash recovery, and optional resumption of interrupted turns.Can omit older tool output from a subsequent prompt without deleting the saved execution record.Supports creating, archiving, renaming, retrying, regenerating, searching, and branching sessions from a turn.Provides workspace instructions, local memory, web search, model settings, sandbox settings, and artifact previews when configured.Offers optional computer-use and catalog-skill capabilities that are disabled by default.Provides MCP client integration through a provider-neutral package.Supports graph execution whose implementation operators use isolated Git worktrees.Runs declarative task-by-repetition-by-subject evaluation experiments with immutable per-cell attempts.Records evaluation score, normalized usage, attributable cost, duration, status, failure reason, and artifacts.Supports built-in Maka and external evaluation subjects plus pluggable executor and subject interfaces.Provides public runtime seams for session orchestration, backend registration, built-in tool composition, workspace execution, events, projections, and recovery.Supports a persistent remote Runtime Host setup on Linux or macOS through the released CLI package.Uses SQLite for live runtime state and local files for connection catalogs, credentials, settings, and artifacts.

Risk profile

Risks and limitations

  • Uncertainty: only selected first-party files were supplied, so implementation details in SECURITY.md, sandbox code, MCP code, computer-use code, skill policy, tests, and release workflows were not directly inspected.
  • Uncertainty: repository metadata and documentation dates extend into 2026 relative to this analysis context, so recency, adoption, issue counts, and release state cannot be independently reconciled.
  • The project explicitly states that it is under active development and that commands, data formats, and experimental capabilities may change.
  • No Apache release exists yet, and Desktop nightly builds are explicitly for developers and testers rather than production.
  • Desktop currently supports Apple Silicon macOS, while Windows is an unsigned preview and Linux and Intel macOS are unsupported.
  • The CLI requires Node.js 22.19 or newer, and some graph, evaluation, peer, or media-facing workflows require additional platform dependencies.
  • Maka does not bundle a shared model account, so useful operation requires a configured API, local model, supported account, or compatible gateway.
  • API keys are stored in a local plaintext credential-vault file protected by the operating-system account boundary rather than an OS keychain.
  • The explicit yolo mode grants full file and network access, substantially weakening the default approval boundary.
  • No native Claude Code integration is documented; classification as an alternative or companion is an inference from Maka's standalone desktop, CLI, and runtime architecture.
  • Optional web search, cloud models, MCP servers, computer use, and external evaluation subjects can expand data exposure and attack surface when configured.
  • No independent security audit, privacy assessment, cross-provider quality benchmark, or comprehensive compatibility matrix was supplied.

Filesystem-writing and shell tools must cross a sandbox boundary, and operations outside it require approval by default; runs can be aborted and failures classified. The CLI documents an explicit yolo mode that grants full file and network access. The Electron renderer has no direct Node API and reaches the main process through a typed contextBridge and guarded IPC. Runtime credentials stay outside the runtime package, but the current credential vault is plaintext and relies on OS-account permissions; POSIX installs enforce owner-only modes. Eval documents authenticated result frames, bounded parsing, egress controls, and fail-closed preflight for selected harnesses, but the supplied implementation was not inspected and some documented egress limits remain.

Component inventory

20 documented components

desktop application

Maka Desktop

Electron/React agent workspace with streaming sessions, tool timelines, artifacts, branching, search, permissions, and recovery.

apps/desktop/
interactive CLI

Maka TUI

Interactive terminal workspace for running Maka in the current project directory.

packages/cli/
CLI command

Maka non-interactive turn

Runs one agent turn and prints the result, with approval required for privileged tools by default.

packages/cli/
workflow

Agent Graph mode

Runs graph-coordinated work; implementation operators use isolated Git worktrees.

packages/cli/
TUI command

Provider setup

Adds or updates API-key model-provider connections from the terminal.

packages/cli/
TUI command

Model selector

Switches the active configured model for terminal agent turns.

packages/cli/
recovery workflow

Safe resume

Optionally resumes interrupted turns through Desktop, CLI, or startup recovery; resumed calls consume model tokens.

docs/architecture/runtime-resume-architecture.md
CLI command and evaluation workflow

Maka Eval

Runs declarative task × repetition × subject experiments with append-only attempts and result selection.

packages/eval/
CLI option

Eval cell replacement

Appends a replacement attempt for one failed or indeterminate evaluation cell.

packages/eval/
TypeScript module API

Eval extension API

Supports custom experiment executors and subject adapters through documented interfaces and CLI dependency overrides.

packages/eval/README.md
service command

Runtime Host setup

Creates a managed persistent remote Runtime Host from the exact invoked package on Linux or macOS.

packages/cli/
service workflow

Runtime Host service updates

Checks, configures, and reconciles verified release-channel updates for a managed Runtime Host.

packages/cli/
CLI command

Maka updater

Stages and verifies a selected release before replacing the local Runtime Host or global CLI package.

packages/cli/
model-visible tool surface

Built-in agent tools

Provides file reading, writing, editing, shell execution, file discovery, and text search under sandbox policy.

packages/runtime/
optional tool capability

Optional Computer Use

Adds computer-use backend selection, host lifecycle, protocol adapters, and model-loop support.

packages/computer-use/
optional skill surface

Catalog skills

Makes catalog-provided skills available to Maka agent sessions.

docs/skill-catalog-policy.md
workspace service

Local memory

Provides local memory to desktop agent workflows when configured.

apps/desktop/
workspace service

Web search

Provides web search to desktop agent workflows when configured.

apps/desktop/
experimental integration

Experimental IM bots

Connects chat applications to Maka Runtime through the documented bot-onboarding architecture.

docs/architecture/bot-onboarding-runtime.zh-CN.md
TypeScript runtime module

@maka/runtime

Pure-Node agent runtime exposing session orchestration, backend registration, tool composition, events, projections, and recovery APIs.

packages/runtime/

Technical profile

Requirements and configuration

License
Apache-2.0, with third-party components under their respective licenses and notices.
PrimaryLanguage
TypeScript according to GitHub metadata.
RepositoryStatus
Public, unarchived Apache Incubator repository on the main branch.
Distribution
Desktop nightly prereleases and the maka-agent npm beta package on the next tag are documented convenience artifacts, not ASF releases.
DesktopStack
Electron main process, context-isolated preload bridge, and React renderer.
Runtime
Pure-Node agent runtime behind a single-owner Runtime Host.
RuntimeAPIs
SessionManager, AgentBackend registry, AiSdkBackend, sandbox execution boundaries, built-in tool composition, RuntimeKernel, events, projections, and recovery helpers are documented public seams.
Storage
SQLite operational state plus local JSON settings, connection catalog, plaintext credential vault, and artifact files.
BuiltInTools
Read, Write, Edit, Bash, Glob, and Grep.
OptionalIntegrations
MCP client integration, computer use, catalog skills, local memory, web search, remote Runtime Host access, and experimental IM bots.
Evaluation
Declarative task × repetition × subject cells with append-only attempts, Harbor and Pier executors, Maka and external subjects, and a small result kernel.
Requirements
Node.js 22.19 or newer, npm, Git, and ripgrep; selected development and evaluation paths require additional Rust, Docker, Python, browser, or platform tooling.
DesktopPlatforms
Apple Silicon macOS is targeted, Windows is preview-only, and Linux and Intel macOS are not supported.
CliPlatforms
Documented release-gate coverage includes Linux x64 and arm64, macOS arm64, and Windows x64 on selected Node versions.
ModelConnectivity
User-supplied cloud API, local-model, supported account, or compatible gateway connection.
LicenseState
The project has not yet made an approved Apache release.

Classification

How it enters the stack

Standalone ApplicationDesktop GuiTool Surface

Evidence: Maka supplies its own Electron desktop, TUI/CLI, Runtime Host, model connections, and model-visible coding tools. No Claude Code plugin, hook, skill, or native bridge is documented. Inference: it runs alongside or replaces Claude Code as a standalone alternative; setup requires Node and a user-configured model.

Standalone · medium setup effort · high confidence · automated

Evidence and risk

Primary sources

first_party_fileREADME.mdhttps://github.com/apache/maka/blob/main/README.md
first_party_filedocs/README.mdhttps://github.com/apache/maka/blob/main/docs/README.md
first_party_fileREADME.zh-CN.mdhttps://github.com/apache/maka/blob/main/README.zh-CN.md
first_party_filepatches/README.mdhttps://github.com/apache/maka/blob/main/patches/README.md

Routing context

Conflicts, complements, and synergies

alternative_to

gh_openai_codex

Both are standalone coding-agent platforms with local CLI operation, model-visible tools, sandbox controls, persistent sessions, SDK or runtime seams, and evaluation-oriented infrastructure; neither is evidenced as a Claude Code extension.

high confidence