Skip to content

Òtítọ́

Local repo intelligence for agents and reviewers

Prepared by: Oluwasegun Olumbe
Status: v1.0.0 — clean Òtítọ́ product cutover, ready for Bashbop publication
Category: Practical AI governance for developers

A Bashbop Ltd product for teams that want context before code changes, review prompts before merge, and less guessing in agent workflows.

About Òtítọ́

Òtítọ́ is a local-first context system. It inspects repositories, builds code maps, creates task-aware context packs, prepares PR review harnesses, and exposes the same workflow through an MCP server.

Its command-line and package identity is otito.

See the How It Works visual walkthrough — a layered diagram of the discover → index → context → gate flow.

:material-sparkles: What's New

v1.0.0 — Òtítọ́ clean cutover (2026-07-29)

  • Start from a local checkout while npm publication is pending.
  • Run the deterministic CLI with otito.
  • Configure MCP with node /path/to/otito/src/cli.js mcp.

See CHANGELOG.md for the full history.

Documentation Pack

# Document Description Status
01 Context Foundation Repository inspection, maps, search, context packs, and harnesses Active
02 MCP and Agents MCP tools and agent-facing workflows Active
03 Bashbop stewardship Protected review, release discipline, and CODEOWNERS Active
04 Release Readiness SemVer, changelog discipline, CI, and release gates Active
05 Trust-Layer Demo Òtítọ́ as a repeatable review workflow Active
06 Builder-Founder Loop Session rhythm, evidence ledger, governance ladder, and next-action rule Active

What otito Provides

Current Capabilities

  • Repository inspection with languages, scripts, entrypoints, and git state
  • AST-backed JSON-first code maps for TypeScript, JavaScript, Go, C#, Python, Java, Ruby, and Rust
  • Multi-domain file tagging so feature subdirs surface under both root and feature names
  • Local discovery, indexing, catalog search, and workspace reports
  • Task-aware context packs before agents plan or edit, with vendor-bundle filtering
  • Data-access surface reports (inline SQL and Prisma) with per-file boosts in context-pack scoring
  • Local-vs-naïve eval suite for measuring otito's token savings
  • PR review context from git diffs and optional GitHub comments
  • Go test-file detection for review-ready repositories
  • MCP tools for repository context, search, maps, and review workflows
  • Contributor-ready governance: CI, CODEOWNERS, templates, security, and release guidance

Context Flow

flowchart LR A[Repo or workspace] --> B[Inspect shape] B --> C[Map files and symbols] C --> D[Build context pack] D --> E[Agent or reviewer] E --> F[Change] F --> G[PR review context] G --> H[Otito gate]

Quick Start

git clone https://github.com/BASHBOP/otito.git
cd otito && npm ci && node src/cli.js doctor

npm ci
npm run ci
node src/cli.js doctor

otito mcp

  • Context Before Change

    Generate the map an agent or reviewer needs before touching the code.

  • Search Across Local Repos

    Discover, index, catalog, and search local repositories without sending code to a hosted model.

  • PR Review Harness

    Turn diffs into review prompts, risk flags, changed domains, and test hints.

  • Governance Ready

    Use Òtítọ́ as a repeatable trust layer: context before change, validation before merge.

  • Public Demo Path

    Show the workflow end to end: context pack, focused change, Òtítọ́ gate, human merge.

  • Company Adoption Case Study

    Package the trust layer for engineering leaders, platform teams, and AI governance reviewers.

  • Builder-Founder Operating Loop

    Keep every coding-agent session tied to context, focused change, visible gates, human decisions, and durable evidence.