mirror of https://github.com/badlogic/pi-mono.git synced 2026-11-05 23:37:25 +00:00

Christian Klotz 2a46c42080

docs(coding-agent): document which working directory resumed sessions use (#11617 )

Closes #11532.

The docs and CLI help did not say which working directory a resumed
session runs in. That directory controls tools, `@path` references,
project configuration, and context files.

## Changes

- `docs/sessions.md`: states that a session keeps the working directory
it was created in, adds a table mapping each entry point to its working
directory, and describes what happens when that directory no longer
exists. Removes a paragraph that repeated the `--session`/`--fork`
descriptions.
- `docs/cli.md` and `--help`: clearer `--continue`, `--resume`,
`--session`, `--session-id`, and `--fork` descriptions. The help only
mentions the directory where it is not obvious (`--fork`).
- `/resume` and `/import` command descriptions, mirrored in
`docs/slash-commands.md`. `/import` notes that it preserves the session
ID and working directory.

| Entry point | Working directory |
|---|---|
| `--continue` | The current directory |
| `--resume`, `/resume`, `--session`, `/import` | The session's working
directory, which can differ from the current directory |
| `--fork`, or a `--session` ID from another directory that you choose
to fork | The current directory, in a new session |

Behavior was verified against `createSessionManager` in `src/main.ts`,
`SessionManager.open`/`continueRecent`/`forkFrom`, and
`AgentSessionRuntime.importFromJsonl`.

2026-10-30 17:22:05 +00:00

2.7 KiB

Raw Blame History

Slash commands

Type / in Pi's terminal editor to search the commands available in the current session. This page lists the built-in commands in the current Pi release.

Extensions, prompt templates, and skills can add commands. The command menu in Pi is therefore the exact reference for the resources loaded in your session.

Models and settings

Command	Description
`/settings`	Open settings
`/model [provider/model]`	Select a model
`/thinking [level]`	Set the thinking level
`/scoped-models`	Configure the models used by interactive cycling
`/login [provider]`	Add provider authentication
`/logout`	Remove provider authentication
`/llama`	Manage models on the configured llama.cpp router

Sessions and context

Command	Description
`/new`	Start a new session
`/resume`	Resume another session
`/name [name]`	Set the session display name, or show the current name when omitted
`/session`	Show current session information and statistics
`/tree`	Navigate the session tree
`/fork`	Create a new session from an earlier user message
`/clone`	Duplicate the current session at its current position
`/compact [instructions]`	Compact the current context, optionally with custom instructions
`/import <path>`	Import a JSONL session, preserving its ID and working directory

Command	Description
`/copy`	Copy the last assistant message
`/export [path]`	Export the session as HTML or JSONL
`/share`	Upload the session and return a viewer link
`/bug [description]`	Prepare a private bug report for the Pi developers

Review a session before exporting or sharing it. Sessions can contain prompts, tool arguments, command output, file contents, and credentials exposed during the conversation.

Runtime and project

Command	Description
`/trust`	Save a project trust decision for future Pi processes
`/mcp`	Manage MCP servers: sign in, reconnect, enable or disable, and change exposure
`/reload`	Reload keybindings, extensions, skills, templates, themes, and context files
`/hotkeys`	Show active keyboard shortcuts
`/changelog`	Show changelog entries
`/quit`	Quit Pi

Commands added by resources

Extensions can register commands with their own arguments and completion behavior.
Each prompt template is available under its template name.
Skills are available as /skill:name when skill commands are enabled.

Use /reload after adding or changing a discovered command resource. See Extensions, Prompt Templates, and Skills for their loading and naming rules.

2.7 KiB Raw Blame History