Skip to content

Commit 70d0e57

Browse files
TheGreatAxiosTheGreatAxios
committed
docs(permissions): format the grant-file help row
1 parent 95791c2 commit 70d0e57

1 file changed

Lines changed: 20 additions & 20 deletions

File tree

‎docs/IMPLEMENTATION.md‎

Lines changed: 20 additions & 20 deletions
Original file line numberDiff line numberDiff line change
@@ -425,27 +425,27 @@ This release changes no settings, OAuth-store, or session persistence format and
425425
Printed by `corbits --help` / `-h` from `CLI_HELP_TEXT` in `src/config/index.ts`
426426
(that constant is the source of truth; keep this table in sync when flags change).
427427

428-
| Verb / Flag | Default | Description |
429-
| ------------------------------------------ | -------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
430-
| _(no verb)_ | — | Interactive session; optional trailing task text |
431-
| `exec` / `run` / `-p` | — | Run a prompt (non-interactive / one-shot). `-p` is the same path as `exec` and may appear in any flag position. |
432-
| `resume` / `continue` | — | Open the session picker for this folder (project-keyed to this checkout's git toplevel). Lists the 10 most recently persisted sessions, completed included. Type to filter. |
433-
| `--resume [<session-id>]` | — | Interactive: open the session picker, or reopen a specific session when an id is given. With `exec` / `-p` the id is required, that session is continued, and the new prompt is sent (no picker). |
434-
| `resume <session-id>` | — | Reopen a specific session in the TUI (does not auto-send a prompt) |
435-
| `exec --resume <session-id>` | — | Headless: load that session and send `<prompt>`, then exit. Missing or unreadable ids error and do not create a session. `--resume` without an id errors. |
436-
| `-p --resume <session-id>` | — | Same headless continue path as `exec --resume` |
437-
| `resume --pick` / `--list` | — | Interactive session picker |
438-
| `--cwd <dir>` | `process.cwd()` | Working directory |
439-
| `--config <path>` | `~/.corbits/settings.json` | Active settings file for provider definitions and TUI persistence such as `/yolo`; composes with (does not exclude) home-level codex/xai OAuth credentials |
428+
| Verb / Flag | Default | Description |
429+
| ------------------------------------------ | -------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
430+
| _(no verb)_ | — | Interactive session; optional trailing task text |
431+
| `exec` / `run` / `-p` | — | Run a prompt (non-interactive / one-shot). `-p` is the same path as `exec` and may appear in any flag position. |
432+
| `resume` / `continue` | — | Open the session picker for this folder (project-keyed to this checkout's git toplevel). Lists the 10 most recently persisted sessions, completed included. Type to filter. |
433+
| `--resume [<session-id>]` | — | Interactive: open the session picker, or reopen a specific session when an id is given. With `exec` / `-p` the id is required, that session is continued, and the new prompt is sent (no picker). |
434+
| `resume <session-id>` | — | Reopen a specific session in the TUI (does not auto-send a prompt) |
435+
| `exec --resume <session-id>` | — | Headless: load that session and send `<prompt>`, then exit. Missing or unreadable ids error and do not create a session. `--resume` without an id errors. |
436+
| `-p --resume <session-id>` | — | Same headless continue path as `exec --resume` |
437+
| `resume --pick` / `--list` | — | Interactive session picker |
438+
| `--cwd <dir>` | `process.cwd()` | Working directory |
439+
| `--config <path>` | `~/.corbits/settings.json` | Active settings file for provider definitions and TUI persistence such as `/yolo`; composes with (does not exclude) home-level codex/xai OAuth credentials |
440440
| `--permissions <path>` | — | Process-only grant file. Its `approvals` replace user-global and provider-model grants for this process and are not merged with `~/.corbits/permissions.json`. Session and project grants still apply; project entries still need trust confirmation. Missing, unreadable, invalid JSON, or a wildcard-only pattern fails at start. |
441-
| `--provider <name>` | from settings | Select a configured provider |
442-
| `--model <id>` | provider default | Select a model for the active provider |
443-
| `--profile <name>` | — | Settings profile |
444-
| `--dangerously-skip-permissions`, `--yolo` | false | Process-only aliases that auto-allow anything not denied by the authorization layer (gate + pre-gate workspace sandboxes; secret-guard / authz hard denies remain). `/yolo [on\|off\|toggle]` persists to the active settings file instead. |
445-
| `--auto` | true (default) | Force auto mode on (workspace writes + unconstrained shell without prompts) |
446-
| `--no-auto` | false | Start with auto mode off (ask on every consequential action); no in-session key toggles it |
447-
| `--help`, `-h` | — | Show help (exit 0 via `CliHelpError`) |
448-
| `--version`, `-V` | — | Print `corbits v` plus the running `package.json` version (exit 0 via `CliVersionError`) |
441+
| `--provider <name>` | from settings | Select a configured provider |
442+
| `--model <id>` | provider default | Select a model for the active provider |
443+
| `--profile <name>` | — | Settings profile |
444+
| `--dangerously-skip-permissions`, `--yolo` | false | Process-only aliases that auto-allow anything not denied by the authorization layer (gate + pre-gate workspace sandboxes; secret-guard / authz hard denies remain). `/yolo [on\|off\|toggle]` persists to the active settings file instead. |
445+
| `--auto` | true (default) | Force auto mode on (workspace writes + unconstrained shell without prompts) |
446+
| `--no-auto` | false | Start with auto mode off (ask on every consequential action); no in-session key toggles it |
447+
| `--help`, `-h` | — | Show help (exit 0 via `CliHelpError`) |
448+
| `--version`, `-V` | — | Print `corbits v` plus the running `package.json` version (exit 0 via `CliVersionError`) |
449449

450450
Positional arguments after flags are joined into the optional initial task delivered when the TUI mounts. With no positional task, the operator starts from an empty prompt.
451451

0 commit comments

Comments
 (0)