Skip to content

Tramalia

Governance and verifiable evidence for building with multiple AI agents. Repo-first.

Git governs human collaboration; Tramalia governs agentic collaboration. It's the change control + audit trail for when several AI agents work on a real project: shared rules, mandatory validations, and verifiable evidence for every close.

Tramalia is a repo-first layer that ensures any agent (Claude Code, Codex, Cursor, Antigravity…) touching the project works under the same rules, runs validations, documents its decisions, leaves verifiable evidence, and hands off clearly. It does this by orchestrating external tools instead of reimplementing them.

  • Repo-first governance

    Shared rules (AGENTS.md), mandatory gates and enforcement at close. All versioned in the repo, not hidden in global configs.

    Architecture

  • Evidence & audit

    close leaves an evidence pack with raw outputs + metadata.json; log is the verifiable audit trail of all agentic work.

    Commands

  • Orchestrates, doesn't reimplement

    Delegates to mise, Serena, Repomix, Semgrep, rulesync… The core runs standalone with Python only; external tools are optional interop.

    Ecosystem

  • Start in 3 commands

    pip install, tramalia init, tramalia doctor. No Node or cloud services to govern your repo.

    Installation

Tramalia at the center of the ecosystem

Tramalia doesn't compete with the other AI tools: it governs and orchestrates them. Each occupies a distinct space; Tramalia is the core that ensures control, traceability and continuity.

flowchart TB
    classDef core fill:#5b4bdb,stroke:#4335b0,color:#ffffff;
    classDef sat  fill:#eef1ff,stroke:#9a92e8,color:#2a2160;
    classDef repo fill:#e7f3d8,stroke:#7cb342,color:#2e4d13;
    classDef agent fill:#fff3dc,stroke:#e0a44a,color:#5a3d0a;

    AG["🤖 AI agents<br/><small>Claude · Codex · Cursor · Antigravity</small>"]:::agent

    subgraph TOOLS["Ecosystem tools · optional interop"]
      direction LR
      GA["Gentle-AI<br/><small>setup</small>"]:::sat
      CX["Serena · Repomix<br/>codebase-memory-mcp<br/><small>context</small>"]:::sat
      EN["Engram<br/><small>memory</small>"]:::sat
      HR["Headroom<br/><small>compression</small>"]:::sat
      MR["mise · rulesync<br/><small>gates · rules</small>"]:::sat
    end

    T["🧩 TRAMALIA<br/><small>governance · gates · evidence · handoff · audit</small>"]:::core
    R["📁 Repo<br/><small>AGENTS.md · docs/ai · .tramalia/evidence</small>"]:::repo

    AG -->|read / write| R
    TOOLS -. orchestrates .-> T
    T ==>|governs| R

Legend: 🟪 Tramalia (core) · 🟦 tools (optional interop) · 🟨 AI agents · 🟩 the repository.

In one line: Gentle-AI enables which agents to use, Engram helps remember, Headroom makes context cheaper, Serena/Repomix/codebase-memory-mcp provide code intelligence, and Tramalia keeps the repo controlled, traceable and consistent.

Start here