Status line
Statuslines
.claude/settings.json
Vendor docs
stdin
| name | type | required | meaning | concept | |
|---|---|---|---|---|---|
| agent.name | string |
Agent name when running with the `--agent` flag or agent settings configured
|
docs ↗ | ||
| context_window.context_window_size | string |
Maximum context window size in tokens. 200000 by default, or 1000000 for models with extended context.
|
docs ↗ | ||
| context_window.current_usage | string |
Token counts from the last API call, described in context window fields
|
docs ↗ | ||
| context_window.remaining_percentage | string |
Pre-calculated percentage of context window remaining
|
docs ↗ | ||
| context_window.total_input_tokens | string |
Token counts currently in the context window, from the most recent API response. Input includes cache reads and writes. Before v2.1.132 these were cumulative session totals
|
docs ↗ | ||
| context_window.total_output_tokens | string |
Token counts currently in the context window, from the most recent API response. Input includes cache reads and writes. Before v2.1.132 these were cumulative session totals
|
docs ↗ | ||
| context_window.used_percentage | string |
Pre-calculated percentage of context window used
|
docs ↗ | ||
| cost.total_api_duration_ms | string |
Total time spent waiting for API responses in milliseconds
|
docs ↗ | ||
| cost.total_cost_usd | string |
Estimated session cost in USD, computed client-side. May differ from your actual bill. Resets to \$0 when `/clear` starts a new session
|
docs ↗ | ||
| cost.total_duration_ms | string |
Total wall-clock time since the session started, in milliseconds
|
docs ↗ | ||
| cost.total_lines_added | string |
Lines of code changed
|
docs ↗ | ||
| cost.total_lines_removed | string |
Lines of code changed
|
docs ↗ | ||
| cwd | string |
Current working directory. Both fields contain the same value; `workspace.current_dir` is preferred for consistency with `workspace.project_dir`.
|
docs ↗ | ||
| effort.level | string |
Current reasoning effort (`low`, `medium`, `high`, `xhigh`, or `max`). Reflects the live session value, including mid-session `/effort` changes. Ultracode is not a distinct level and reports as `xhigh`. Absent when the current model does not support the effort parameter
|
docs ↗ | ||
| exceeds_200k_tokens | string |
Whether the total token count (input, cache, and output tokens combined) from the most recent API response exceeds 200k. This is a fixed threshold regardless of actual context window size.
|
docs ↗ | ||
| fast_mode | string |
Whether fast mode is enabled for the session
|
docs ↗ | ||
| model.display_name | string |
Current model identifier and display name
|
docs ↗ | ||
| model.id | string |
Current model identifier and display name
|
docs ↗ | ||
| output_style.name | string |
Name of the current output style
|
docs ↗ | ||
| pr.number | string |
Open pull request for the current branch. Mirrors the PR badge in the bottom status bar. Absent until a PR is found, when not in a git repository, or once the PR merges or closes
|
docs ↗ | ||
| pr.review_state | string |
Review status of the open PR: `approved`, `pending`, `changes_requested`, or `draft`. May be independently absent even when `pr` is present
|
docs ↗ | ||
| pr.url | string |
Open pull request for the current branch. Mirrors the PR badge in the bottom status bar. Absent until a PR is found, when not in a git repository, or once the PR merges or closes
|
docs ↗ | ||
| prompt_id | string |
UUID identifying the user prompt currently being processed. Matches the `prompt.id` attribute on OpenTelemetry events. Absent until the first user input. Requires Claude Code v2.1.196 or later
|
docs ↗ | ||
| rate_limits.five_hour.resets_at | string |
Unix epoch seconds when the 5-hour or 7-day rate limit window resets
|
docs ↗ | ||
| rate_limits.five_hour.used_percentage | string |
Percentage of the 5-hour or 7-day rate limit consumed, from 0 to 100
|
docs ↗ | ||
| rate_limits.seven_day.resets_at | string |
Unix epoch seconds when the 5-hour or 7-day rate limit window resets
|
docs ↗ | ||
| rate_limits.seven_day.used_percentage | string |
Percentage of the 5-hour or 7-day rate limit consumed, from 0 to 100
|
docs ↗ | ||
| session_id | string |
Unique session identifier
|
docs ↗ | ||
| session_name | string |
Session name. Uses the custom name set with the `--name` flag or `/rename` when one exists, otherwise the AI-generated session title. The default display name, such as `my-app-3f`, doesn't populate this field. Absent when the session has neither a custom name nor an AI-generated title
|
docs ↗ | ||
| thinking.enabled | string |
Whether extended thinking is enabled for the session
|
docs ↗ | ||
| transcript_path | string |
Path to conversation transcript file
|
docs ↗ | ||
| version | string |
Claude Code version
|
docs ↗ | ||
| vim.mode | string |
Current vim mode (`NORMAL`, `INSERT`, `VISUAL`, or `VISUAL LINE`) when vim mode is enabled
|
docs ↗ | ||
| workspace.added_dirs | string |
Additional directories added via `/add-dir` or `--add-dir`. Empty array if none have been added
|
docs ↗ | ||
| workspace.current_dir | string |
Current working directory. Both fields contain the same value; `workspace.current_dir` is preferred for consistency with `workspace.project_dir`.
|
docs ↗ | ||
| workspace.git_worktree | string |
Git worktree name when the current directory is inside a linked worktree created with `git worktree add`. Absent in the main working tree. Populated for any git worktree, unlike `worktree.*` which applies only to `--worktree` sessions
|
docs ↗ | ||
| workspace.project_dir | string |
Directory where Claude Code was launched, which may differ from `cwd` if the working directory changes during a session
|
docs ↗ | ||
| workspace.repo.host | string |
Repository identity parsed from the `origin` remote, for example `"github.com"`, `"anthropics"`, `"claude-code"`. Absent outside a git repository or when no `origin` remote is configured
|
docs ↗ | ||
| workspace.repo.name | string |
Repository identity parsed from the `origin` remote, for example `"github.com"`, `"anthropics"`, `"claude-code"`. Absent outside a git repository or when no `origin` remote is configured
|
docs ↗ | ||
| workspace.repo.owner | string |
Repository identity parsed from the `origin` remote, for example `"github.com"`, `"anthropics"`, `"claude-code"`. Absent outside a git repository or when no `origin` remote is configured
|
docs ↗ | ||
| worktree.branch | string |
Git branch name for the worktree (for example, `"worktree-my-feature"`). Absent for hook-based worktrees
|
docs ↗ | ||
| worktree.name | string |
Name of the active worktree. Present only during `--worktree` sessions
|
docs ↗ | ||
| worktree.original_branch | string |
Git branch checked out before entering the worktree. Absent for hook-based worktrees
|
docs ↗ | ||
| worktree.original_cwd | string |
The directory Claude was in before entering the worktree
|
docs ↗ | ||
| worktree.path | string |
Absolute path to the worktree directory
|
docs ↗ |