pi-mono/packages/coding-agent/src/cli
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
..
args.ts docs(coding-agent): document which working directory resumed sessions use (#11617) 2026-10-30 17:22:05 +00:00
auth-check.ts feat(coding-agent): add auth preflight 2026-08-06 19:43:52 +02:00
auth-command.ts fix(coding-agent): use APP_NAME in user-facing messages (#8067) 2026-08-14 11:26:20 +02:00
config-selector.ts fix(tui): remove coding-agent config reads from pi-tui 2026-09-03 11:59:14 +02:00
credential-print.ts fix(coding-agent): resolve model references through one provider selection policy (#10913) 2026-10-14 11:00:21 +01:00
file-processor.ts feat(ai,coding-agent): add image input limits (closes #9631) 2026-09-20 22:59:16 +02:00
initial-message.ts chore(ts): use source import extensions 2026-05-20 00:04:03 +02:00
list-models.ts fix(coding-agent): make model refresh cancellation caller-owned 2026-08-04 00:03:52 +02:00
project-trust.ts feat(ui): Improved project approval settings 2026-06-09 13:25:54 +02:00
session-picker.ts feat(coding-agent): load session picker progressively 2026-09-20 00:48:26 +02:00
setup.ts fix(coding-agent): keep remote harness dependencies development-only 2026-09-05 12:45:04 +02:00
startup-ui.ts feat(coding-agent,tui): System theme (#10067) 2026-09-26 13:33:47 +02:00