Skip to content
MCP server

TruthTrail

Posts your coding agent's product decisions on the Jira or GitHub ticket for sign-off

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, self-hosted
Runs
Locally
Version
0.4.4
Listing updated
2 days ago

About TruthTrail

TruthTrail is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

A coding agent often has to pick an answer the ticket never gave, and the choice stays in a chat nobody else reads. TruthTrail records each decision as the agent works, files it under the ticket key found in the branch name, and posts one summary comment on the Jira Cloud ticket or GitHub issue. It mentions the person who wrote the ticket, who replies /confirm D-2 or /reject D-2 with a reason. Before implementing, the agent reads the ticket's decisions and reworks anything rejected.

A GitHub App adds a pull request check: rejected decisions fail it, waiting ones stay neutral, and all confirmed passes. A lead can make waiting fail too. The npx truthtrail why command shows the decisions behind a given line.

Without signing in, everything stays in .decisions/ in the repo. Signed in, the server keeps encrypted decision text, never source code, diffs or conversations. It supports Claude Code, Cursor and GitHub Copilot.

Install

Run in a terminal

claude mcp add truthtrail -- npx -y truthtrail

Add to claude_desktop_config.json

{
  "mcpServers": {
    "truthtrail": {
      "command": "npx",
      "args": [
        "-y",
        "truthtrail"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "truthtrail": {
      "command": "npx",
      "args": [
        "-y",
        "truthtrail"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "truthtrail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "truthtrail"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "truthtrail": {
      "command": "npx",
      "args": [
        "-y",
        "truthtrail"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "truthtrail": {
      "command": "npx",
      "args": [
        "-y",
        "truthtrail"
      ]
    }
  }
}

What it does

Decision log
Agent questions and assumptions saved under the ticket in .decisions/.
Ticket comments
One summary comment on Jira Cloud or GitHub Issues.
Confirm or reject
Reporters reply with /confirm or /reject and a reason.
PR check
Shows confirmed, waiting and rejected decisions on pull requests.
Why lookup
Shows the decisions behind a line of code.
Privacy boundary
Stores decisions only, not code or conversation.

Good for

  • Let ticket authors vet an agent's assumptions
  • Block merging while a decision is rejected
  • Explain odd behaviour during QA
  • Trace why code was written a certain way

Pricing

Open source

MIT-licensed CLI and MCP server; team features free during beta

Prices change. Check truthtrail.pages.dev before you buy.

TruthTrail FAQ

Which agents and trackers work?

Claude Code, Cursor and GitHub Copilot, with Jira Cloud and GitHub Issues.

How do I set it up?

Run npx truthtrail init once per repo and commit the result.

What if the branch has no ticket key?

The agent asks once and remembers it for that branch.

What does it cost?

Free while in beta; team pricing will be announced before the beta ends.

What is stored on the server?

Encrypted decisions, never source code, diffs or conversations.

Is TruthTrail free?

Yes. TruthTrail is open source, so you can use and self-host it for free.

How do I add TruthTrail to Claude Code?

Run this command in your terminal: claude mcp add truthtrail -- npx -y truthtrail

What are the best alternatives to TruthTrail?

The closest alternatives to TruthTrail are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to TruthTrail

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity