# Import Claude Code Sessions

Bring sessions you ran in the Claude Code CLI into Nimbalyst so you can browse, search, resume, and continue them in the Agent Window.

### How to use

1. Open **File → Import Claude Code Sessions...**

<figure><img src="/files/yKSl5UcY0VYOe7aTrHLJ" alt=""><figcaption></figcaption></figure>

2. 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've already imported (Claude Code added more turns since last import)
* **In Sync** sessions that already match what's in Nimbalyst

<figure><img src="/files/6Dx0nsTzFVyYFmFyjUCk" alt=""><figcaption></figcaption></figure>

3. Search by title, expand the project group, and check the sessions you want to import.
4. 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nimbalyst.com/session-management/import-claude-code-sessions.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.