The Technical Workflow

From install to identity in five minutes.

Ribo isn't just another CLI tool. It's an ontological bridge between your intent and your infrastructure. Here is the path from zero to unified system intelligence.

terminalbrew install go-ribo/taps/ribo

Install the Binary

Ribo is distributed as a lightweight, statically linked Go binary. Zero dependencies, instant execution. Optimized for high-frequency CLI usage and CI/CD pipelines.

shell

$ brew install go-ribo/taps/ribo

Initialize Workspace

Running ribo init creates a .ribo directory. This acts as the local vault for your identity metadata, local vector cache, and semantic truth artifacts.

shell

$ ribo init --project-name "apollo-core"

# Creating local metadata store...

# Initializing semantic indexer...

✓ Success: Workspace ready.

ribo-config.yaml

identity:

name: "service-mesh-auth"

intent: "Verify mTLS certificates across clusters"

invariants:

- "Certificates must be refreshed every 24h"

- "Zero-trust policy enforced at the edge"

contracts:

upstream: ["vault-api", "pki-manager"]

downstream: ["envoy-proxy"]

Encode Identity

This is where the magic happens. You define the Intent, Invariants, and Contractsof your system as truth artifacts. Ribo doesn't just read code; it understands the purpose of your architecture. This metadata creates a "Technical Authority" that agents and teammates can query.

Search by Meaning

Forget grepping for variable names. Use natural language to query your infrastructure. Ribo maps your semantic query against the encoded identities and the codebase truth artifacts.

Query

"Where is the rate limiting logic for the external API?"

insights

Result

/pkg/limiter/fixed_window.go (98% match)

schema

Semantic Mapping Visualization

Connect AI Agents (MCP)

Ribo fully supports the Model Context Protocol (MCP). Expose your encoded truth artifacts and system identity to Claude, GPT, or local LLMs. Your agents no longer guess—they query the Ribo authority.

// ribo-mcp-config.json

{

"mcpServers": {

"ribo": {

"command": "ribo",

"args": ["mcp", "serve"],

"env": {"RIBO_TOKEN": "rt_8x2..." }

}

Collaborate on ribo.dev

Sync your local truth artifacts to the cloud platform. Share semantic definitions across your engineering organization, track architectural drift in real-time, and provide a unified API for all internal developer tools.

verifiedShared Architectural Authority
verifiedAutomated Drift Detection
verifiedSSO & Team Access Control

groups

Team Sync

Centralize semantic definitions across all distributed team workspaces.

Identity Sharing

cloud_sync

Live Refresh

Real-time indexing of truth artifacts as they are pushed to main.

Instant Updates

history

Versioned Intent

Historical tracking of how architectural purpose evolves over time.

Timeline View

security

RBAC

Granular control over who can modify or view sensitive system metadata.

Security Core

Ready to redefine your technical authority?

Install the CLI, encode your first artifact, and connect your agents in under five minutes.

Get Started Free Read the Docs