Log inSubmit server
Loki Mode logo

Loki Mode

Autonomous coding-agent CLI with a stdio MCP server exposing 34 tools for verified changes, receipts, and pull requests.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Loki Mode

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "loki-mode": {
      "command": "npx",
      "args": [
        "-y",
        "loki-mode"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Install not yet sandbox-tested— we haven't run this command through our automated sandbox yet. Not a red flag; we're working through the catalog.

Overview

loki-mode is an autonomous coding-agent CLI and stdio MCP server that exposes 34 tools for turning tasks or repository issues into implementation work. It builds from a task, PRD, or GitHub, GitLab, or Jira issue, runs verification checks, and can open a pull request. Each run produces a locally signed receipt that can be checked independently with the CLI. Reach for it when a coding agent needs a structured build-and-verify workflow rather than an untracked code-generation session.

Use cases

  • Turn a repository task into a verified pull request
  • Build a change from a PRD or issue reference
  • Check signed receipts from completed coding runs
  • Coordinate and verify changes across multiple repositories

Key features

  • 34 MCP tools over stdio
  • Task, PRD, and issue-driven coding workflow
  • Signed Ed25519 run receipts
  • Automated verification and outcome reporting
  • Pull request creation with verified or partial status
  • Multi-repository composite receipts

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

51/55 checks healthy over the last 92d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · loki-mode (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars1.1kStargazers on the source repository.
npm downloads88kPackage downloads in the last 30 days.
Last commit1d agoMost recent push to the default branch.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Loki Mode works

What loki-mode does

loki-mode combines a coding-agent workflow with an MCP server that exposes 34 tools over stdio. Its primary workflow accepts a task description, a PRD file, or an issue reference such as owner/repo#123. The agent derives a delivery contract, writes checks from the requested behavior, implements the change, verifies the result, and records the outcome.

A successful run can open a pull request containing the requested change, test information, and details about what was not proven. Runs can also stop without opening a pull request when they fail, hit a budget, encounter a specification conflict, or become stalled. --no-pr supports building and verifying locally without creating a pull request.

How it works

The CLI runs against a model provider, with Claude Code as the default provider. The bundled Agent SDK can use ANTHROPIC_API_KEY, and the workflow also recognizes OPENAI_API_KEY for spend-cap behavior. Other coding CLIs can be selected with --provider.

After implementation, loki-mode seals a receipt at .loki/runs/<run-id>/receipt.json. The receipt is signed with a local Ed25519 key created on first use. loki verify re-hashes the receipt, checks its signature against the event log, and verifies that the checkout still matches the sealed code. A public key can be exported for verification on another machine.

For multi-repository work, a workspace can combine child receipts into a signed composite receipt. The composite verification result cannot exceed the weakest child result.

Setup and configuration

Install the package globally with npm:

Terminal
npm install -g loki-mode

The package installs the Bun runtime as an optional dependency. Bun, Homebrew, and Docker installation paths are also available. Run loki setup for the first-run wizard, or use loki doctor --fix.

A basic task looks like this:

bash
cd your-repo
loki start "add rate limiting to /api/login"

Use loki edit for a single targeted change, loki quick for a small task with verification, and loki chat for an interactive Plan and Build workflow. Set --max-cost to limit a run, --provider to choose a coding CLI, or budgets.per_run in loki.yaml to configure a budget.

Tools and capabilities

  • Exposes 34 MCP tools over stdio.
  • Converts tasks, PRDs, and supported issue references into coding work.
  • Runs implementation and verification steps.
  • Opens ready or draft pull requests based on the result.
  • Creates signed, locally verifiable run receipts.
  • Supports receipt-gated multi-repository workspaces.
  • Offers optional deployment through explicit policy and execution controls.

Limitations and notes

A receipt records only the checks that ran; its signature establishes who produced it, not that the code is free of defects. Verification can report an unchecked result if the checkout no longer matches the sealed code. Declared behavior changes normally require a fail-to-pass Wall test, although LOKI_MUTATION_STRICT=0 can opt out.

Deployment requires loki deploy --execute or loki start --deploy, a verified HEAD-anchored receipt, and permission from .loki/policies.json. The propose, execute, and operate autonomy settings control whether runs may open pull requests or deploy. The default spend cap is $100 when an Anthropic or OpenAI API key is set; subscription-based logins have no dollar cap by default.

The npx loki-mode start and npx loki-mode tour demonstrations can produce receipts without a provider or key. The initial package download still requires network access.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Loki Mode

loki-mode is an MCP server that connects coding agents to repository tasks and issues, exposing 34 stdio tools for autonomous implementation, verification, pull-request creation, and signed receipt generation. It works alongside the loki-mode CLI, which accepts tasks, PRDs, and GitHub, GitLab, or Jira issue references.

Install loki-mode globally with `npm install -g loki-mode`; its MCP server is included in the package and communicates over stdio. Bun, Homebrew, and Docker installation options are also available.

Yes, loki-mode uses the standard stdio MCP transport, so it can be configured in MCP clients that support standard stdio servers, including Cursor. The coding workflow itself uses a model provider such as Claude Code or another selected coding CLI.

loki-mode re-runs declared checks, seals the run in a signed receipt, and lets you inspect it with `loki verify`. Verification checks the receipt hash, Ed25519 signature, event log, and whether the checkout still matches the sealed code.

Related MCP servers

All in Coding Agents All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewLoki Mode AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/loki-mode?style=directory)](https://allmcps.com/mcp/loki-mode)
HTML Embed
<a href="https://allmcps.com/mcp/loki-mode"><img src="https://allmcps.com/api/badge/loki-mode?style=directory" alt="Loki Mode on AllMCPs" /></a>