elephant

You know the ritual.

Claude has the entire problem in its head. It has read the repo, found the bug, changed six files, failed one test, and finally understood why.

Then:

You've hit your usage limit.

You open another agent. It cheerfully asks what you are working on.

Now you are the context window.

Elephant removes that part.

Without / with Elephant

Without Elephant:

Claude:  You've hit your usage limit.
Codex:   What would you like to work on?
You:     Okay, so first you need to understand this 47-message conversation...

With Elephant:

Claude:    You've hit your usage limit.

           [open the same repo in Codex]

Elephant:  Recovered the previous Claude Code session.
           Objective: fix refresh-token rotation.
           State: implementation complete; one integration test still fails.
           Changed: auth/session.py, tests/test_rotation.py

Codex:     I found the failing test. Continuing from there.

The dead model does not need to summarize anything. Elephant was already recording while it was alive.

How it works

Elephant is a plugin, not another command you babysit.

Every prompt, response, tool call, failure, and file change
                         │
                         ▼
             append-only local journal
                         │
              completed turn / compaction /
              interruption / quota failure
                         │
                         ▼
                recovery capsule
                         │
             open the repo in another agent
                         │
                         ▼
             objective + state + Git evidence

It remembers:

• the current objective and last completed state;
• the last prompt and model response;
• modified files and live Git state;
• recent tool/model failures;
• the latest 20 session events;
• a redacted transcript reference when the host exposes one.

Every capture-capable native shell writes the same versioned event format. They share ~/.elephant/elephant.db, so Claude's memory is visible to Codex, Hermes, Pi, OpenCode, Copilot, and every other Elephant adapter.

Three layers

┌──────────────────────────────────────────────────────────────┐
│ Native shells                                               │
│ Claude · Codex · Hermes · OpenCode · Pi · Copilot · Gemini │
├──────────────────────────────────────────────────────────────┤
│ Elephant kernel                                             │
│ redact · journal · checkpoint · inspect Git · build capsule │
├──────────────────────────────────────────────────────────────┤
│ Continuation                                                │
│ automatic startup injection · Elephant Resume              │
└──────────────────────────────────────────────────────────────┘

One memory format. Thin native adapters. No universal fake CLI pretending every agent exposes the same API.

Install

Install once in each harness you want to hand work between. Python 3.11+ must be available as python3 for the local kernel and lifecycle hooks.

Claude Code

Send these as two separate prompts inside Claude Code:

/plugin marketplace add vishesh9131/elephant

/plugin install elephant@elephant

Elephant adds lifecycle capture, the local MCP recovery tools, automatic startup recovery, and /elephant:resume.

Codex

codex plugin marketplace add vishesh9131/elephant

Open /plugins, choose the Elephant marketplace, and install Elephant. Review and trust its local lifecycle hooks when Codex asks, then start a new session.

GitHub Copilot CLI

copilot plugin marketplace add vishesh9131/elephant
copilot plugin install elephant@elephant

The same commands work interactively with a / prefix. Elephant captures all nine Copilot CLI plugin lifecycle events and provides the resume skill.

Gemini CLI

gemini extensions install https://github.com/vishesh9131/elephant --ref=v0.2.0

Gemini loads Elephant's project context and resume skill. The public repo is tagged for Gemini's extension gallery crawler.

Pi

pi install git:github.com/vishesh9131/elephant@v0.2.0

Requires Node.js 22.19+. Pi loads the native JavaScript extension, /resume, and skill:resume.

Hermes Agent

hermes plugins install vishesh9131/elephant --enable

Restart Hermes after installing. Elephant registers native lifecycle hooks, the elephant_recover tool, the resume skill, and /elephant.

Why /elephant instead of /resume? Hermes already owns /resume. The elephant remembers names too.

OpenCode

From a checkout, point your opencode.json at Elephant's JavaScript plugin:

{
  "plugin": ["/absolute/path/to/elephant/.opencode/plugins/elephant.mjs"]
}

The plugin captures prompts, responses, tool calls, compaction, idle, errors, and session end. The npm package is prepared but not published yet.

The rest of the herd

Not every harness exposes lifecycle hooks. Elephant says exactly what each one can do instead of painting “98% quota used” on a guess.

See the full platform matrix for capability details and current conformance status.

What happens near quota?

Mostly, nothing special—and that is the point.

Most coding harnesses do not expose an exact subscription percentage. Elephant never invents one. Quota signals are stored as exact, estimated, or unknown.

Instead of gambling everything on a mythical “99% used” callback, Elephant:

1. journals continuously;
2. checkpoints after every completed model turn;
3. checkpoints again before compaction and at session end;
4. records native interruption and quota-failure events when the host provides them.

If the quota dies without warning, the memory is already on disk.

Local means local

Elephant has no account, cloud, analytics, telemetry, ad network, or mysterious “improve the product” upload.

~/.elephant/
├── elephant.db       # append-only events + recovery capsules
└── transcripts/      # optional compressed transcript copies

Sensitive keys and common credential formats are redacted before persistence. Redaction is defense-in-depth, not magic: protect the machine and do not share the database casually.

Set ELEPHANT_DATA_DIR to move the store. Read the privacy notice and security policy.

Resume explicitly

Automatic recovery happens when a native host starts a new session in a project that has an Elephant capsule from another session.

When you want to ask directly:

Recovery compares the capsule's Git metadata with the live worktree. The files on disk win. Elephant remembers the past; it does not overwrite the present.

Tested, not merely listed

The conformance suite proves the same flow across adapters:

capture → checkpoint → switch harness → recover → verify Git state

The current release includes:

• real plugin-load checks for Claude Code, OpenCode, Pi, Copilot, and Hermes when their binaries are installed, plus remote marketplace discovery in Codex;
• live model-turn verification for Copilot CLI and Hermes;
• cross-harness Claude → OpenCode → Pi → portable recovery contracts;
• 11 Python/JavaScript tests for journaling, redaction, MCP, manifests, and continuation.

Run everything