aimem-cli

AiMem - AI Memory Switcher

AiMem helps you save, inspect, compress, and transfer conversation context between AI coding agents. When one agent hits a token limit, rate limit, or you simply want to switch tools, AiMem lets the next agent continue with the context you already built.

Install

pip install aimem-cli

From source:

git clone https://github.com/ThangTo/AiMem.git
cd AiMem
pip install -e .

Run the interactive TUI:

aimem-cli

What Is New In 0.2.8

• Fixed OpenCode injection so imported messages no longer block the next real prompt from calling the LLM.
• Fixed OpenCode message timestamps so new chats are not inserted between older imported messages.
• Restored TUI resume flow after injection, including opening opencode -s <session-id> in a new terminal.
• Fixed Codex CLI injection by writing complete base instructions and visible transcript events.
• Improved Codex VS Code extension launch through the correct deep link flow.
• Added --no-compress so compression is only used when explicitly requested or enabled.
• Added regression tests for OpenCode injection ordering, model selection, and context budgeting.

Core Features

• Interactive TUI with session selection, analysis, chunking, compression, injection, and resume actions.
• Save sessions from Claude, Gemini, Qwen, OpenCode, Codex, Cursor, Aider, Continue.dev, or clipboard.
• Load sessions as Markdown, Claude, Gemini, Qwen, OpenCode, Codex, Cursor, Continue.dev, or prompt format.
• Inject directly into supported agent storage, then resume in the target tool.
• Analyze context size against the target model before loading.
• Chunk large sessions while preserving all messages.
• Optional LLM compression with explicit --compress and --no-compress controls.
• Merge multiple sessions into a single context package.

Quick Start

Interactive Mode

aimem-cli

Use the TUI to:

• Pick a source session.
• Analyze, chunk, compress, copy, or inject it.
• Open the injected target session directly when supported.

Transfer Claude To OpenCode

aimem-cli save --from claude
aimem-cli load <session-id> --to opencode --inject
opencode -s <opencode-session-id>

In the TUI, after injection you can choose to open the OpenCode session immediately in a new terminal.

Transfer To Codex

aimem-cli save --from claude
aimem-cli load <session-id> --to codex --inject
codex resume <codex-session-id>

The TUI also supports opening the injected Codex session in the terminal or in the VS Code extension.

Transfer Through Markdown

aimem-cli save --from claude
aimem-cli load <session-id> --to markdown --copy

Paste the generated context into any AI assistant.

Commands

Initialize Config

aimem-cli init
aimem-cli init --force

Save A Session

aimem-cli save --from claude
aimem-cli save --from gemini
aimem-cli save --from qwen
aimem-cli save --from opencode
aimem-cli save --from codex
aimem-cli save --from cursor
aimem-cli save --from aider
aimem-cli save --from continue
aimem-cli save --from clipboard

Save a specific session when the adapter supports it:

aimem-cli save --from opencode --session-id <session-id>

Load Or Convert A Session

aimem-cli load <session-id> --to markdown
aimem-cli load <session-id> --to claude
aimem-cli load <session-id> --to gemini
aimem-cli load <session-id> --to qwen
aimem-cli load <session-id> --to opencode
aimem-cli load <session-id> --to codex
aimem-cli load <session-id> --to cursor
aimem-cli load <session-id> --to continue
aimem-cli load <session-id> --to prompt

Inject Into Target Storage

aimem-cli load <session-id> --to claude --inject
aimem-cli load <session-id> --to gemini --inject
aimem-cli load <session-id> --to qwen --inject
aimem-cli load <session-id> --to opencode --inject
aimem-cli load <session-id> --to codex --inject
aimem-cli load <session-id> --to cursor --inject

OpenCode model override:

aimem-cli load <session-id> --to opencode --inject --opencode-model google/gemma-4-31b-it

Analyze, Chunk, Compress

aimem-cli load <session-id> --to opencode --analyze
aimem-cli load <session-id> --to opencode --chunk
aimem-cli load <session-id> --to opencode --compress --inject
aimem-cli load <session-id> --to opencode --no-compress --inject

Merge Sessions

aimem-cli merge <session-a> <session-b>
aimem-cli merge <session-a> <session-b> --smart
aimem-cli merge <session-a> <session-b> --smart --to gemini

Config

aimem-cli config
aimem-cli config set compression.enabled true
aimem-cli config set compression.enabled false
aimem-cli config set compression.api_key YOUR_API_KEY
aimem-cli config set compression.provider groq
aimem-cli config set output.clipboard_auto true

Delete

aimem-cli delete <session-id>

Supported Agents

Sources

Injection Targets

Configuration

Config file:

~/.aimem/config.json

Important options:

Development

pip install -e ".[dev]"
python -m pytest
python -m build

Project layout:

aimem/
  cli.py
  tui.py
  models.py
  storage.py
  compression.py
  context_manager.py
  adapters/
    claude.py
    gemini.py
    qwen.py
    opencode.py
    codex.py
    cursor.py
    aider.py
    continue_dev.py

License

MIT License. See LICENSE.

Contributing

See CONTRIBUTING.md.