Import Claude Code Sessions

Import sessions from the Claude Code CLI into Nimbalyst so you can browse, search, resume, and continue past terminal conversations visually.

If you have been using the Claude Code CLI in a terminal, you can bring those sessions into Nimbalyst and continue them in the Agent window. Imported sessions become regular Nimbalyst sessions: you can browse, search, and resume them, and they keep their full history.

Nimbalyst runs on top of the Claude Code you already have installed, so imported CLI sessions keep working the same way. See the Claude Code GUI page.

How to import

1. Open File > Import Claude Code Sessions...

The import command lives in the File menu.

1. The import dialog scans your Claude Code session storage for sessions tied to the current workspace and shows totals at the top:

• Total sessions found

• New sessions not yet imported

• Updates to sessions you have already imported (Claude Code added more turns since your last import)

• In Sync sessions that already match what is in Nimbalyst

The dialog shows each session's age, message count, and sync status. Check the ones you want, then click Import.

1. Search by title, expand the project group, and check the sessions you want to import.

2. Click Import n Sessions.

Imported sessions show up in the Agent window session list and the kanban board. You can resume them, link them to tracker items, or open them in a worktree just like any other Nimbalyst session.

What gets imported

• Full conversation history, including subagent turns

• Extended-thinking blocks

• Long tool results (inlined so they show up in the transcript)

• Follow-up prompts within a turn

Workspace matching

Nimbalyst matches Claude Code's on-disk session directories to your current workspace. Workspaces with spaces, apostrophes, or accented characters in their path are handled correctly.

If the workspace-filtered scan finds nothing, the dialog falls back to showing all available Claude Code sessions and tells you the scope was broadened, so you can still import sessions that Claude Code stored under a different resolved path or sibling worktree.

Tips

• Import is idempotent. Running it again on a session that already matches Nimbalyst's copy is a no-op; it shows up under In Sync.

• Has Updates means Claude Code added more turns to a session since you last imported it. Re-checking and re-importing brings the new turns over.

• Import works with sessions from Claude Code 2.1.x and later.