> ## Documentation Index > Fetch the complete documentation index at: https://docs.augmentcode.com/llms.txt > Use this file to discover all available pages before exploring further. # CLI Flags and Options > A comprehensive reference for all command-line flags available in the Auggie CLI. You're viewing docs for **Auggie 1.x.x** (prerelease). To see Auggie 0.x.x, go to [the 0.x.x docs](https://docs.augmentcode.com/cli/v0/reference.md) . ## CLI flags | Command | Description | | :- | :- | | `auggie` | Start Auggie in interactive mode | | `auggie --print "Summarize the staged changes"` (`-p`) | Run one instruction in print mode and exit | | `auggie --print --mode stream "Summarize the staged changes"` | Stream text and tool activity as it happens | | `auggie --print --mode json "Summarize the staged changes"` | Output structured JSON events for automation workflows | | `auggie --print --show-cost "Summarize the staged changes"` | Include cost and credit usage in the output | | `auggie --acp` | Run Auggie as an [ACP](https://docs.augmentcode.com/cli/acp/agent.md) agent for compatible editors and clients | ### Input | Command | Description | | :- | :- | | `auggie "Fix the typescript errors"` | Provide an initial instruction in interactive mode | | `auggie --print "Summarize the staged changes"` | Provide an instruction and exit | | `cat file \| auggie --print "Summarize this data"` | Pipe content through stdin | | `auggie @prompt.md @screenshot.png "Explain this UI error"` | Include files and images in the initial message | | `auggie --print --enhance-prompt "Fix the flaky test"` | Run the prompt enhancer before sending the instruction | | `auggie --append-system-prompt ` | Append text or file contents to the system prompt | ### Custom Commands | Command | Description | | :- | :- | | `auggie command list` | List available custom commands | | `auggie command [args...]` | Execute a custom command | | `auggie command help ` | Show help for a custom command | See [Custom Commands](https://docs.augmentcode.com/cli/custom-commands.md) for detailed information on creating and managing custom commands. ### Sessions | Command | Description | | :- | :- | | `auggie --continue` (`-c`) | Continue the most recent session | | `auggie --resume` (`-r`) | Interactively choose a saved session to resume | | `auggie --session ` | Use a specific session file | | `auggie --fork ` | Fork a session file or partial session ID into a new session | | `auggie --session-dir ` | Directory for session storage and lookup | | `auggie --no-session` | Do not save the session | | `auggie --export [output.html]` | Export a session file to HTML and exit | | `auggie session list` | List saved sessions from the current workspace (`--all`, `--json`, `-n `) | | `auggie session stats [sessionId]` | Show session statistics, including cost and credit usage | Resuming a session restores its `--permission` and `--add-workspace` values unless you pass them again. ### Workspace | Command | Description | | :- | :- | | `auggie --workspace-root /path/to/project` (`-w`) | Specify the root of the workspace (defaults to the git root) | | `auggie --add-workspace /path/to/another/project` | Index an additional workspace alongside the primary workspace (repeatable) | | `auggie --discover-workspaces[=depth]` | Discover git repositories under a non-git workspace root | | `auggie --no-discover-workspaces` | Disable git repository discovery | | `auggie --worktree [slug]` | Create or reuse a git worktree for this session | | `auggie --allow-indexing` | Allow indexing for the current workspace and skip the confirmation screen | | `auggie --wait-for-indexing` | Wait for workspace indexing to finish before the first agent turn | | `auggie --augment-cache-dir /path/to/dir` | Relocate the Augment config and cache directory (default `~/.augment`) | ### Models | Command | Description | | :- | :- | | `auggie --model "name"` | Select the model. Append `:` to set the reasoning effort, for example `sonnet:high` | | `auggie --thinking ` | Set the reasoning effort. Use `default` to clear the override | | `auggie --models ` | Comma-separated model patterns to cycle through | | `auggie model list [search]` | List available models (`--json` for full metadata) | ### Rules, skills, and resources | Command | Description | | :- | :- | | `auggie --rule ` | Load a rule file or directory (repeatable) | | `auggie --no-rules` | Disable rule discovery | | `auggie --skill ` | Load a skill file or directory (repeatable) | | `auggie --no-skills` | Disable skill discovery | | `auggie --prompt-template ` | Load a prompt template file or directory (repeatable) | | `auggie --theme ` | Load a theme file or directory (repeatable) | > [!NOTE] > > Skills are loaded automatically from `.augment/skills/` and `.claude/skills/` directories in both your workspace and home directory. See [Skills](https://docs.augmentcode.com/cli/skills.md) for more information. ### Tools | Command | Description | | :- | :- | | `auggie --tools read,bash,edit,write` | Enable only the listed built-in tools (`read`, `bash`, `edit`, `write`, `grep`, `find`, `ls`) | | `auggie --no-tools` | Disable all built-in tools | | `auggie --remove-tool ` | Remove a tool by name for the current session (repeatable) | | `auggie --permission bash:ask-user` | Set a tool permission rule for the current run (repeatable) | | `auggie --enable-tool-search` | Hide individual MCP tools behind `find-tool` and `execute-tool` | For fine-grained control over tool behavior (allow, deny, ask-user), see [Permissions](https://docs.augmentcode.com/cli/permissions.md). ### Plugins and extensions | Command | Description | | :- | :- | | `auggie plugin marketplace add ` | Add a plugin marketplace from a repository or URL | | `auggie --plugin-dir ` | Load and enable plugins from a local marketplace directory (repeatable) | | `auggie install [-l]` | Install an extension package and add it to settings (`-l` for project settings) | | `auggie remove [-l]` | Remove an extension package from settings | | `auggie update [source]` | Update installed extension packages | | `auggie list` | List installed extension packages | | `auggie config` | Enable or disable package resources | | `auggie --extension ` (`-e`) | Load an extension file for this run (repeatable) | | `auggie --no-extensions` | Disable extension discovery | Use `/plugins` in interactive mode to browse and manage plugins. See [Plugins and Marketplaces](https://docs.augmentcode.com/cli/plugins.md). Auggie 1.x is built on [pi](https://github.com/earendil-works/pi), so [pi extensions](https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/extensions.md) should work in Auggie. Install them with `auggie install` instead of `pi install`. > [!WARNING] > > Extensions are third-party code that runs with your user permissions and can read your files, run commands, and > send data anywhere. Augment does not review, control, or support third-party extensions and is not responsible for > what they do, including any data they access or share. Only install extensions from sources you trust. > > Auggie includes changes to pi, so an extension may behave differently in Auggie than in pi. If something isn't > working, let us know with `/feedback`. ### MCP and integrations | Command | Description | | :- | :- | | `auggie mcp add [options] ` | Create or update a named MCP server configuration (`--project` or `--local` to choose the settings file) | | `auggie mcp add-json ` | Add an MCP server from JSON configuration | | `auggie mcp list` | Display all configured MCP servers | | `auggie mcp remove ` | Remove a named MCP server configuration | | `auggie --mcp-config ` | Load MCP server configuration from inline JSON or a file (repeatable) | > [!NOTE] > > `--mcp-config` overrides MCP servers defined in settings files. For detailed usage examples, options, settings.json format, and precedence rules, see [Integrations and MCP](https://docs.augmentcode.com/cli/integrations.md#manage-mcp-servers-with-the-auggie-cli). ### Cloud | Command | Description | | :- | :- | | `auggie --cloud` | Stream this session to Cosmos so it is visible and steerable from the web UI | | `auggie --no-cloud` | Disable cloud mode | | `auggie cloud ` | Manage cloud resources. See [Cloud](https://docs.augmentcode.com/cli/cloud.md) | ### Authentication | Command | Description | | :- | :- | | `auggie auth login [--headless]` | Log in to Augment and store the session locally | | `auggie auth logout` | Remove the local session | | `auggie auth status` | Show the current authentication status | | `auggie token print` | Print the current session JSON for automation | | `auggie token revoke` | Revoke tokens for the current user and remove the local session | | `auggie --augment-session-json ` | Authenticate with inline session JSON or a session file | ### Diagnostics | Command | Description | | :- | :- | | `auggie --log-file ` | Write logs to the given file. Defaults to a temp file | | `auggie --log-level ` | Set the log level: `error`, `warn`, `info` (default), or `debug` | | `auggie --verbose` | Show the startup header even if `quietStartup` is set | | `auggie --offline` | Disable startup network operations | | `auggie --check-startup` | Boot, print startup diagnostics as JSON, and exit | ### Additional commands | Command | Description | | :- | :- | | `auggie upgrade` | Upgrade Auggie to the latest version in its channel | | `auggie --help` (`-h`) | Show help | | `auggie --version` (`-v`) | Show version | ## Environment Variables | Variable | Description | | - | - | | `AUGMENT_SESSION_AUTH` | Authentication JSON | | `AUGMENT_DISABLE_AUTO_UPDATE` | Disable automatic CLI updates | ## See Also * [Settings](https://docs.augmentcode.com/cli/settings.md) - Configure Auggie with `/settings` and `settings.json` * [Custom Rules and Guidelines](https://docs.augmentcode.com/cli/rules.md) - Configure custom rules for project-specific guidance * [Skills](https://docs.augmentcode.com/cli/skills.md) - Extend capabilities with specialized domain knowledge * [Custom Commands](https://docs.augmentcode.com/cli/custom-commands.md) - Create reusable command templates * [Plugins and Marketplaces](https://docs.augmentcode.com/cli/plugins.md) - Manage and install plugins to extend Auggie * [Permissions](https://docs.augmentcode.com/cli/permissions.md) - Configure tool permissions and security * [Integrations](https://docs.augmentcode.com/cli/integrations.md) - Connect external tools and services This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.