Local-first session memory

KAGE

Find, review, fork, and bridge AI coding sessions across Claude Code, Codex, QoderCLI, and QoderWork without uploading transcript content.

Install the CLI
$ curl -fsSL https://raw.githubusercontent.com/farmcan/kage/main/install.sh | bash
Desktop + CLI Transcript search Native resume bridges No hosted index Latest: v0.1.17
How KAGE thinks

One local layer over scattered agent memory.

KAGE does not need a hosted index to feel useful. It reads what your tools already write, groups it by project, then prepares explicit actions you can run.

Local stores

Separate transcripts

Each agent keeps its own files and resume rules.

Claude.claude
Codex.codex
QoderCLI.qoder

KAGE index

Project memory

Directory first, then agent, date, title, and transcript text.

Searchtext
Filteragent
Lineagesidecar

Explicit actions

No surprise launches

KAGE prepares commands and exports; you decide what runs.

Resumenative
Forkbranch
Bridgec2x

Next surface

Continue where it fits

Use CLI, desktop, or trusted LAN monitor without sending transcripts away.

CLIscript
Desktopreview
ServeLAN

Start with the CLI.

Install KAGE, check which local agent stores it can see, then list or search the sessions already on your machine. Bridge only when you are ready to continue context in another agent.

1 Install

Install the command line tool.

This downloads the repo package, installs the global kage command, and keeps transcripts local.

Terminal
$ curl -fsSL https://raw.githubusercontent.com/farmcan/kage/main/install.sh | bash
2 Check

See what KAGE can read.

Use doctor first if you are not sure whether Claude Code, Codex, or QoderCLI sessions exist locally.

Terminal
$ kage doctor
3 List

Find recent local sessions.

Start with a small recent window, then open the desktop app when you want the visual workspace.

Terminal
$ kage sessions --since 30d --limit 20
4 Continue

Search or bridge one useful thread.

Search transcript text first; when a Claude session should continue in Codex, run the bridge.

Terminal
$ kage search "auth" --limit 10
kage c2x

Stop losing useful agent work.

Agent transcripts are already on your machine. KAGE turns them into local project memory you can search, inspect, continue, and move between tools.

Find Search by project, agent, date, title, or transcript text.

Skip raw JSONL folders and jump back to the session where the useful decision happened.

Bridge Move context into native resume formats.

Continue Claude Code work in Codex, move Codex context to QoderCLI, or keep lineage sidecars for audit.

Stay local Keep transcripts on disk instead of a hosted index.

KAGE scans local agent stores and exposes desktop, CLI, and trusted LAN workflows around them.

CLI in one command

Use this path for scripting, bridge commands, session search, and local web monitoring.

Terminal
$ curl -fsSL https://raw.githubusercontent.com/farmcan/kage/main/install.sh | bash

macOS desktop app

Browse sessions, filter agents, inspect context, and run explicit resume or bridge actions.

The current DMG is unsigned. If macOS blocks first launch, right-click KAGE.app and choose Open.

Concrete flows, no visual hand-waving.

KAGE should earn attention by doing useful local work first: find sessions, inspect context, and move memory between agents only when you ask it to.

Find Start from a directory, then narrow by agent.

Use project scope as the main mental model, with Codex, Claude, QoderCLI, and QoderWork filters when needed.

Inspect Read the session before taking action.

Search titles, recent prompts, transcript text, and dates so you can choose the right memory instead of guessing.

Continue Resume, fork, bridge, or replay deliberately.

KAGE prepares native commands and exports; launching or changing a live agent still stays explicit.

Built around the way agents actually store sessions.

KAGE does not replace Codex, Claude Code, or QoderCLI. It gives you the missing local layer for discovery, cleanup, replay, and target-native bridge exports.

Desktop Select a project and inspect recent sessions.

Directory is the primary context; agent filters help separate Codex, Claude, QoderCLI, and QoderWork.

Actions Resume, fork, bridge, replay, or reveal files.

Actions are explicit, previewable, and backed by CLI JSON so the app stays a thin local shell.

Mobile agent monitor See what your agents are doing from your phone.

See what local agents are doing from phone or tablet without turning KAGE into cloud sync.

Native bridges without copy-paste.

Cross-agent exports use target-native UUID session ids and keep source lineage in sidecars. The command you get is the command you run.

Route Use it when
kage c2x Continue a Claude Code session in Codex.
kage x2c Move useful Codex context into a Claude Code resume file.
kage x2q Bridge a Codex session into QoderCLI with a matching sidecar.
kage sessions --since 90d --limit 120 List a bounded recent session window for large local histories.
kage serve --password 1234 Open the local web monitor for a trusted phone or tablet.