Documentation

Introduction

Tribal is a collaborative platform for sharing coding agent sessions across your engineering team. It works with Claude Code, Cursor, Codex, and any other AI coding agent.

Why Tribal?

When engineers work with AI coding agents, valuable context is locked in individual sessions. Tribal makes this context available to your entire team:

• Share session history and context automatically
• Search across all team sessions to find solutions
• Fork sessions to build on teammate's work
• Track what your team is building with analytics

Installation

Step 1: Create an account

Sign up for a free Tribal account at app.uselineage.io

Step 2: Create a workspace

Once signed in, create your first workspace. Workspaces are shared environments where your team's sessions live.

Step 3: Get your API key

Navigate to Settings → API Keys and generate a new key. You'll need this to connect your coding agent.

export TRIBAL_API_KEY="tribal_xxxxxxxxxxxxx"

Quick Start

Connect Claude Code

Install the Tribal extension for Claude Code:

claude-code install tribal

Configure your workspace:

tribal init
tribal workspace connect my-team-workspace

That's it! Your sessions will now automatically sync to your team workspace.

Viewing team sessions

Use the Tribal dashboard or CLI to browse your team's sessions:

tribal sessions list
tribal sessions search "authentication bug"

Claude Code Integration

Tribal has first-class support for Claude Code with automatic session syncing and deep integration.

Installation

claude-code install tribal
tribal login

Configuration

Configure which sessions to sync in your .tribal/config.json:

{
  "workspace": "my-team",
  "sync": {
    "auto": true,
    "exclude_patterns": ["*.secret", "credentials/*"]
  }
}

Working with Sessions

Creating sessions

Sessions are created automatically as you work with your coding agent. Each conversation becomes a session that's synced to your workspace.

Sharing sessions

All sessions in your workspace are automatically shared with your team. You can also generate shareable links:

tribal session share <session-id>

Privacy controls

Mark sessions as private to keep them out of the shared workspace:

tribal session mark-private <session-id>

API Reference

Authentication

All API requests require authentication using your API key in the Authorization header:

curl https://api.uselineage.io/v1/sessions \
  -H "Authorization: Bearer tribal_xxxxxxxxxxxxx"

List sessions

GET /v1/sessions

Returns all sessions in your workspace.

Get session details

GET /v1/sessions/:id

Returns full details and conversation history for a specific session.

Create session

POST /v1/sessions

Create a new session programmatically.