# cumora

> Run Cumora agents on your own machine with Claude Code, Codex, Antigravity, and other BYOA engines.

Latest version **0.18.7** (published 2026-09-22) · MIT license · 0 weekly downloads

## Install

```sh
npm install cumora
pnpm add cumora
yarn add cumora
bun add cumora
```

Provides the command `cumora`.

## Health

**Score 60/100 (C)** — status: active.

Positive: esm support; no vulnerabilities; recently updated; high maintenance score.

Warnings: low downloads; no types; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.18.7 |
| Published | 2026-09-22 |
| First published | 2026-05-25 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | ESM |
| Node | >=18 |
| Dependencies | 0 |
| Unpacked size | 373.4 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| Maintainers | yetone |
| Keywords | cumora, agent, claude-code, codex, antigravity, pi |

## Links

- npm: https://www.npmjs.com/package/cumora
- Homepage: https://cumora.ai
- npm.io page: https://npm.io/package/cumora

## Alternatives

- [@openai/codex-sdk](https://npm.io/package/@openai/codex-sdk.md) — 731.4K weekly downloads
- [babel-plugin-transform-react-jsx](https://npm.io/package/babel-plugin-transform-react-jsx.md) — 565.0K weekly downloads
- [babel-helper-remove-or-void](https://npm.io/package/babel-helper-remove-or-void.md) — 508.5K weekly downloads
- [@pnpm/store-controller-types](https://npm.io/package/@pnpm/store-controller-types.md) — 186.9K weekly downloads
- [react-native-signature-canvas](https://npm.io/package/react-native-signature-canvas.md) — 155.6K weekly downloads

## Recent versions

- 0.18.7 (latest) — 2026-09-22
- 0.18.6 — 2026-09-19
- 0.18.5 — 2026-09-17
- 0.18.4 — 2026-09-15
- 0.18.3 — 2026-09-15
- 0.18.2 — 2026-09-13
- 0.18.1 — 2026-09-10
- 0.18.0 — 2026-09-10
- 0.17.0 — 2026-09-09
- 0.16.2 — 2026-09-06
- 0.16.1 — 2026-09-06
- 0.16.0 — 2026-09-06
- 0.15.0 — 2026-09-05
- 0.14.2 — 2026-09-03
- 0.14.1 — 2026-09-03
- … 85 more at https://npm.io/package/cumora/versions

## README

# cumora

Run your [Cumora](https://cumora.ai) agents on your own machine or VPS,
powered by your local agent CLI (BYOA — Bring Your Own Agent). Claude Code and
Codex are sandboxed by default; Grok Build, Cursor Agent, OpenCode, pi, Gemini,
Qwen Code, and Antigravity require an explicit unsandboxed compatibility opt-in. One daemon can
host many agents; each gets its own workspace, memory, and skills on that
machine.

## Usage

In Cumora: **You → Computers → Add a computer** to get a pairing code, then
on the machine you want to host agents:

```sh
npx cumora agent computer --pair <code> [--server <your-server-url>]
```

Then start the daemon (after pairing, the config is saved):

```sh
npx cumora agent computer [--server <your-server-url>]
```

`--server` is optional; it defaults to `https://api.cumora.ai`. Pass it when
you self-host.

Requires **Node ≥ 18** and a supported CLI on your `PATH`. Secure mode supports
Claude Code **≥ 2.1.248** on macOS/Linux/WSL2 and Codex **≥ 0.138.0** on
macOS/Linux/WSL2/native Windows. Older CLIs fail closed instead of falling back
to host-level authority.
The daemon talks to the Cumora server over HTTPS only — it needs no database
access. See the repository's `docs/BYOA.md` before enabling
`CUMORA_BYOA_ALLOW_UNSANDBOXED=1`; that switch grants model-generated tools the
host's ordinary file, environment, and network authority.

---
_Source: https://npm.io/package/cumora · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._