Apache Maka (Incubating) is a local-first agent workspace for the terminal and desktop. A background Rust Runtime Host owns model execution, sandboxing, permissions, and SQLite state, keeping an auditable record of every run, approval, and tool receipt.
Prerequisites: Rust stable, Node.js 24+ (CI uses 26), npm, and just. Native Computer Use also requires Xcode Command Line Tools on macOS or X11 development libraries on Linux.
git clone https://github.com/apache/maka.git
cd maka
just setup
just runjust run launches the terminal workbench and connects to (or starts) the local Host at ~/.maka/application/host. Pass --root <path> to use a different State Root, --session <id> to open an existing conversation, or --help to inspect CLI subcommands.
To build release binaries for both the CLI and the native desktop window:
just build --release
target/release/maka desktopOn macOS, just build stages Maka.app alongside maka; on Windows, binaries carry .exe. Both the terminal and desktop shells run the same NSH workbench UI against the same Host process—closing the window detaches the UI while in-flight work finishes in the background.
In WSL, just run skips the Linux native-desktop feature and bridges Computer Use to the Windows desktop by default. Point MAKA_CUA_WINDOWS_EXECUTABLE to a matching Windows maka.exe when running from source; see Computer Use.
| Directory | Role |
|---|---|
| platform/ | Plugin kernel, SQLite event log, Host runtime, V8/Python sandboxes, OS isolation, and Computer Use |
| plugins/ | Agent runtime, workspace tools, skills, settings, interactions, and shared domain contracts |
| products/maka/ | Product composition, NSH workbench, CLI, ACP server, and terminal/desktop shells |
| products/eval/ | Containerized Harbor evaluation runner against the native Host |
| packages/plugin-sdk/ | Generated TypeScript contracts and helpers for Host and NSH UI plugins |
| packages/cli/ | @maka-agent/cli npm launcher for platform-native binaries |
| scripts/rust/ | Native packaging, V8 prebuilt management, license checks, and CI suite runner |
website/ |
Project website (independent package manifest and lockfile) |
Run just --list to see common development recipes. Further reading: Architecture, UI Design, Contributing, and Security.
Apache Releases: The latest approved release is Apache Maka 0.2.2 (incubating). The signed source archive is the official release; see the downloads page and .github/ASF_SOURCE_RELEASE.md for verification instructions.
Convenience builds: @maka-agent/cli is a thin npm wrapper that dispatches to a platform-specific native binary package built from a single verified source archive; see packages/cli.
Apache Maka is an effort undergoing incubation at The Apache Software Foundation (ASF). See DISCLAIMER, LICENSE, and NOTICE.
