Use this walkthrough to ask a question about a project, continue the conversation, and reopen it after exiting. You need an installed application, the Claude CLI on PATH for sign-in, and a project directory you are comfortable letting Claude inspect. Account access and usage limits are controlled by Anthropic; see the billing note.
Open a terminal in your project directory and run:
claude-rsThe directory you start in is the session's working directory. Check the location shown by the app before proceeding. To select a different directory at launch, use claude-rs -C path/to/project with your own path.
If the app asks whether to trust the project, review the directory before accepting. If authentication is required, use the sign-in flow offered by the app or run claude auth login from your shell and start again. See login troubleshooting if sign-in does not complete.
When the composer is ready, type the following and press Enter:
Read this project's README and summarize its purpose and how to run it. Do not change files.
Choose a project with a README for this example. Claude may read files or request permission to use a tool. Review the requested action and choose from the displayed options. Declining an action can prevent Claude from completing the task; you can still explain what you want in a follow-up.
You should see the reply and any tool output in the conversation. The answer depends on the project; success is a completed response explaining its purpose and run instructions, with the composer available for the next message.
If no response arrives, distinguish a waiting permission or question from a connection failure. Respond to the visible prompt, or use the startup troubleshooting steps.
Ask a follow-up:
Which file should I read first to understand the main workflow?
Finished output remains in your terminal's scrollback. Use Page Up to read earlier output inside the app and Ctrl+End to return to the latest output. Esc cancels an active turn; it does not undo work already completed.
Enter /help to open built-in help. Close the fullscreen view with Esc to return to the conversation. For multiline input and context-specific controls, see Keyboard shortcuts.
After the response completes, press Ctrl+Q to quit. When a session was established, the app prints a command for resuming it.
From the same project directory, run:
claude-rs --resumeChoose the conversation you just used and press Enter. Its saved history should appear, and you can ask another question. The picker searches by name, session ID, or branch. To continue the most recent conversation directly, use claude-rs --continue; if none exists, that command starts a new session.
- Work with conversations: resume, fork, review Git changes, copy responses, export, and inspect subagents.
- Configure claude-rs: save preferences and distinguish them from current-session choices.
- Use MCP servers and plugins: inspect connections and load local plugins.
- CLI reference: launch flags, shell completions, and local manuals.