context-bridge

# Context Bridge

**Never lose project context again.** Context Bridge creates persistent memory across agent sessions, letting you resume complex projects days or weeks later with full context of conversations, decisions, and progress.

## When to Use

- Resuming work on a multi-day project
- Recalling what was decided in previous sessions
- Finding past conversation threads about a topic
- Bridging context after time away from a project
- Building institutional memory of your work
- Preventing repeated explanations to your agent
- Tracking decision history and reasoning
- Creating project narratives over time

## The Problem This Solves

**Agents forget between sessions.** Every `/new` command wipes the slate clean. You waste time re-explaining context, re-sharing decisions, and re-establishing what you were working on.

**Context Bridge remembers for you.** It saves conversation threads, decisions, file changes, and reasoning - then reconstructs full context when you return.

## Quick Start

### Save Current Session Context

```bash
# Save context with a project name
echo "Save this session as: api-redesign" | openclaw agent

# Or save with description
echo "Save context: api-redesign - Switched from REST to GraphQL" | openclaw agent
```

### Resume a Previous Session

```bash
# Resume specific project
echo "Resume context: api-redesign" | openclaw agent

# List available contexts
echo "List saved contexts" | openclaw agent

# Search contexts by keyword
echo "Find contexts about authentication" | openclaw agent
```

## Core Commands

### Save Context

```bash
# Save current session
echo "save context as project-name" | openclaw agent

# Save with description
echo "save context as project-name: brief description" | openclaw agent

# Auto-save on /new (if context-bridge hook enabled)
/new  # Automatically prompts to save current context
```

### Resume Context

```bash
# Resume by project name
echo "resume context: project-name" | openclaw agent

# Resume latest se...

# Context Bridge

**Never lose project context again.** Resume multi-session projects with full conversation history, decisions, and progress.

## The Problem

Agents forget between sessions. Every `/new` command wipes memory. You waste time re-explaining context.

## The Solution

Context Bridge creates persistent memory across sessions:
- Saves conversation threads
- Tracks decisions and reasoning
- Records file changes
- Links related sessions
- Enables semantic search

## Quick Start

```bash
# Save current session
echo "save context as: my-project" | openclaw agent

# Resume later
echo "resume context: my-project" | openclaw agent

# Search past work
echo "find contexts about authentication" | openclaw agent
```

## What Makes This Different

Unlike simple session logs, Context Bridge:
- ✅ Extracts decisions and reasoning
- ✅ Links related conversations
- ✅ Semantic search across all contexts
- ✅ Project-oriented organization
- ✅ Timeline visualization

## Installation

```bash
# Install via ClawHub
clawhub install context-bridge

# Enable auto-save hook (optional)
openclaw hooks enable context-bridge-autosave
```

## Use Cases

**Multi-day projects**: Resume work with full context  
**Decision tracking**: "What did we decide about the API design?"  
**Knowledge building**: Aggregate related work into knowledge base  
**Team handoffs**: Export contexts for documentation  

## Core Features

### Save & Resume
```bash
echo "save context as: api-redesign" | openclaw agent
echo "resume context: api-redesign" | openclaw agent
```

### Search & Discover
```bash
echo "find contexts about database" | openclaw agent
echo "list contexts tagged: backend" | openclaw agent
```

### Decision Tracking
```bash
echo "what decisions were made in: api-redesign" | openclaw agent
echo "decision timeline for: api-redesign" | openclaw agent
```

### Context Management
```bash
echo "list contexts" | openclaw agent
echo "merge contexts: project-a, project-b into: combined" | openc...