sscoble/pi-mono
1
0
Fork 0
mirror of https://github.com/badlogic/pi-mono.git synced 2026-11-05 23:37:25 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4

docs(coding-agent): document -- end-of-options delimiter

Browse source
This commit is contained in:
Armin Ronacher 2026-08-23 00:01:33 +02:00
parent 74786a748f
commit 62bcbf6be0
3 changed files with 15 additions and 3 deletions
Download patch file Download diff file Expand all files Collapse all files

6
packages/coding-agent/README.md
View file

@ -514,7 +514,7 @@ Read the [blog post](https://mariozechner.at/posts/2025-11-30-pi-coding-agent/)
## CLI Reference
```bash
pi [options] [@files...] [messages...]
pi [options] [--] [@files...] [messages...]
```
### Package Commands
@ -613,6 +613,7 @@ Combine `--no-*` with explicit flags to load exactly what you need, ignoring set
| `--verbose` | Force verbose startup |
| `-a`, `--approve` | Trust project-local files for this run |
| `-na`, `--no-approve` | Ignore project-local files for this run |
| `--` | Stop option parsing; remaining arguments are prompts or `@file` inputs |
| `-h`, `--help` | Show help |
| `-v`, `--version` | Show version |
@ -635,6 +636,9 @@ pi "List all .ts files in src/"
# Non-interactive
pi -p "Summarize this codebase"
# Prompt beginning with a dash
pi -p -- "- Summarize these points"
# Non-interactive with piped stdin
cat README.md | pi -p "Summarize this text"

6
packages/coding-agent/docs/usage.md
View file

@ -142,7 +142,7 @@ If you use pi for open source work and want to publish sessions for model, promp
## CLI Reference
```bash
pi [options] [@files...] [messages...]
pi [options] [--] [@files...] [messages...]
```
### Package Commands
@ -246,6 +246,7 @@ pi --no-extensions -e ./my-extension.ts
| `--verbose` | Force verbose startup |
| `-a`, `--approve` | Trust project-local files for this run |
| `-na`, `--no-approve` | Ignore project-local files for this run |
| `--` | Stop option parsing; remaining arguments are prompts or `@file` inputs |
| `-h`, `--help` | Show help |
| `-v`, `--version` | Show version |
@ -272,6 +273,9 @@ pi "List all .ts files in src/"
# Non-interactive
pi -p "Summarize this codebase"
# Prompt beginning with a dash
pi -p -- "- Summarize these points"
# Non-interactive with piped stdin
cat README.md | pi -p "Summarize this text"

6
packages/coding-agent/src/cli/args.ts
View file

@ -262,7 +262,7 @@ export function printHelp(extensionFlags?: ExtensionFlag[]): void {
console.log(`${chalk.bold(APP_NAME)} - AI coding assistant with read, bash, edit, write tools
${chalk.bold("Usage:")}
${APP_NAME} [options] [@files...] [messages...]
${APP_NAME} [options] [--] [@files...] [messages...]
${chalk.bold("Commands:")}
${APP_NAME} install <source> [-l] Install extension source and add to settings
@ -316,6 +316,7 @@ ${chalk.bold("Options:")}
--approve, -a Trust project-local files for this run
--no-approve, -na Ignore project-local files for this run
--offline Disable startup network operations (same as PI_OFFLINE=1)
-- End option parsing; treat remaining arguments as messages/files
--help, -h Show this help
--version, -v Show version number
@ -340,6 +341,9 @@ ${chalk.bold("Examples:")}
# Non-interactive mode (process and exit)
${APP_NAME} -p "List all .ts files in src/"
# Prompt beginning with a dash
${APP_NAME} -p -- "- Summarize these points"
# Multiple messages (interactive)
${APP_NAME} "Read package.json" "What dependencies do we have?"