faq · asked, answered

Asked, answered.

If something here is still unclear, the code is open and the inbox is real.

Is this another workspace or IDE I have to move my team into?

No, and that is the point. Motif is a background layer, not a surface. Your team keeps its own editors, terminals and habits; a small daemon watches, syncs and serves session memory. There is a dashboard, but nobody has to live in it.

What does "hand off natively" actually mean?

Motif writes the target tool's own session file and registers it in that tool's own state, so the session opens as native history with full context. It runs in both directions between Claude Code and Codex, and you can hand a session to a teammate rather than to a tool: it lands in their editor through their own daemon.

Where do our sessions live?

In ~/.motif on each machine, and in a single SQLite file on a server you host yourself: one docker compose up, port 4680. Sessions never leave your infrastructure, there is no telemetry, and secret redaction runs on the source machine before anything uploads.

Which tools are supported?

Motif collects from Claude Code, Codex and Cursor, and writes native sessions for Claude Code and Codex. New readers are the most welcome contribution: each one is a small module modeled on the existing three.

What is session memory?

The server distills idle sessions into entity notes (files, decisions, topics) with supersession and conflict detection, powered by a pluggable LLM provider: Anthropic, OpenAI, any openai-compatible endpoint, or a local model. Off by default.

What happens when a tool changes its session format?

Readers are pinned against captured fixtures and covered by tests on Linux, macOS and Windows. When a format shifts, one reader update fixes it for everyone, and because the project is open source that fix can come from you.

How do I keep a private project out of the team server?

Filtering happens on your machine before upload: include and exclude globs, a selected-projects allowlist mode, and --purge to withdraw sessions that were already synced. The server never sees what you excluded.

Is it really free?

Yes. Apache-2.0, self-hosted, no accounts, no seats, nothing feature-locked. motif up runs the same server solo on your laptop; delete ~/.motif and it is gone, your tools keep working exactly as before.

← back to the pattern