# Nimbus — The Local Apex Runtime

Run real Apex locally — no Salesforce org. Nimbus executes your SOQL, DML, triggers, and
flows against an embedded PostgreSQL database, then tests, debugs, and covers them — on your
machine, in milliseconds. No Docker, no JVM.

Nimbus is a complete local Apex runtime — not just a test runner. It bundles a step
debugger, a language server (LSP), a browser Dev UI, mutation testing, code coverage,
an MCP server for AI agents, and a local Salesforce-compatible REST/gRPC server.

## Quick install

```bash
curl -fsSL https://testnimbus.dev/install.sh | sh
```

Or visit https://testnimbus.dev/quickstart for the full guide.

## What Nimbus does

Nimbus replaces the inner development loop for Salesforce developers. Instead of
pushing code to a scratch org and waiting minutes for test results, Nimbus runs
everything locally:

- **Real Apex execution** — classes, triggers, flows, SOQL, DML. Not a mock.
- **Sub-second tests** — a typical test runs in under 50ms.
- **Full coverage** — line and branch coverage in JUnit XML, Cobertura, HTML, and JSON.
- **Built-in debugging** — set breakpoints, step through code, inspect variables.
- **Mutation testing** — verifies your tests actually catch bugs (Pro feature).
- **MCP server** — `nimbus mcp` exposes test tooling as Model Context Protocol tools for AI agents (Claude Code, Cursor, Copilot).

## Use cases

- **Local TDD** — write Apex tests on your laptop, on a plane, anywhere.
- **Fast CI** — JUnit XML and Cobertura output plug into GitHub Actions, GitLab CI, SonarQube, Codecov. No connected org required.
- **AI agent integration** — AI coding agents call `nimbus test` or `nimbus mcp` for sub-second write-test-fix loops.
- **Headless 360** — custom MCP servers wrapping `@InvocableMethod`, `@AuraEnabled`, `@RestResource`, and autolaunched Flows test offline.

## Pricing

| Tier | Price | Includes |
|---|---|---|
| Free | $0 forever | Apex runtime, unlimited tests, SOQL/DML/triggers/flows, code coverage, VS Code & JetBrains integration, 1 machine |
| Pro | $0 (beta) | Everything in Free, plus daemon, local Salesforce REST/gRPC server, parallel execution, watch mode, debugger, mutation testing, MCP, LSP, 3 machines |
| Team | $15/dev/month | Everything in Pro, plus JUnit XML/Cobertura CI output, 5 seats, prioritized support |

## Key links

- [Docs / CLI Reference](https://testnimbus.dev/docs)
- [FAQ](https://testnimbus.dev/faq)
- [Quickstart](https://testnimbus.dev/quickstart)
- [AI & Agentic Coding](https://testnimbus.dev/agentic)
- [Security](https://testnimbus.dev/security)
- [Changelog](https://testnimbus.dev/changelog)
- [Privacy](https://testnimbus.dev/privacy)
- [Terms](https://testnimbus.dev/terms)

## MCP Server

Nimbus ships an MCP server accessible via stdio:

```
nimbus mcp
```

Tools: `run_apex_tests`, `get_coverage`, `list_test_classes`, `get_trace`, `run_anonymous_apex`

Register with Claude Code:
```
claude mcp add nimbus -- nimbus mcp
```

## Contact

- Slack: https://join.slack.com/t/nimbuslocalap-tj23081/shared_invite/zt-3x7fxoo38-AAgO9QHP7if53JPunBxOPQ
- Email: support@testnimbus.dev
- GitHub: https://github.com/nimbus-solution
