Skip to content
apachePublic

About

Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6.0k stars

Watchers

26 watching

Forks

Latest commit

 

History

8,010 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Maka Apache Maka (Incubating)

简体中文

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.

Quick start

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 run

just 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 desktop

On 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.

Repository layout

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.

Distribution

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.

About

Apache Maka (Incubating) is a high-performance agent workspace that keeps a complete record of everything it did.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

6.0k stars

Watchers

26 watching

Forks

Releases

Packages

Used by

Contributors

Languages