Skip to main content
command CX Codex

update_status_line — Claude Code command: setup and usage

update_status_line upserts custom key-value metadata into Claude Code session records. Useful for displaying custom task statuses or project flags in your status line.

no license ★ 3,990 updated 2026-03-04

Install into Claude Code · Manually: put the files in place All methods and platforms ↓
.claude/commands/update_status_line.md
Open on GitHub

What update_status_line does

The command accepts three positional parameters: a session identifier, a target property name, and its new value. It looks up the target session record located under .claude/data/sessions/{session_id}.json.

It parses the existing record, initializes an extras dictionary if missing, and writes the specified key-value pair into it. Once written, the command returns a short summary containing the file path, modified key, prior value, and updated value.

The target session file must already exist at .claude/data/sessions/{session_id}.json, because the command only updates existing records rather than creating new session logs from scratch.

What it helps with

  • store custom task flags in session metadata
  • track active subproject names in status outputs
  • inject arbitrary key-value pairs into session files
  • inspect previous and updated values after an edit

Example prompts for the agent

  • /update_status_line 4c932bd7-ee06-46e3-b26b-f32f52cc0862 branch staging
  • /update_status_line 4c932bd7-ee06-46e3-b26b-f32f52cc0862 phase migration

How to install update_status_line

Manually: put the files in place

.claude/commands/update_status_line.md

Call it with /update_status_line. For all projects use ~/.claude/commands/

Questions about update_status_line

How to install update_status_line in Claude Code?

Place the command definition file at .claude/commands/update_status_line.md.

What does update_status_line do?

It inserts or overwrites custom attributes inside the extras mapping of a session JSON file.

Which file does update_status_line modify?

The command updates .claude/data/sessions/{session_id}.json using the provided identifier.

Similar slash commands

All slash commands for Agent setup: memory, context, orchestration →

From the same set25

The whole set →
crypto_news_scanner_agent_prompt crypto_news_scanner_agent_prompt — a slash command that pulls recent crypto headlines and returns the 5 biggest with sources. Handy for a quick market check. CX Codex +1 ★ 3,990repo stars crypto_price_check_agent_prompt crypto_price_check_agent_prompt fetches current cryptocurrency prices in USD directly inside Claude Code. Checks Bitcoin if no token ticker is provided. CX Codex +1 ★ 3,990repo stars crypto_movers_agent_prompt crypto_movers_agent_prompt finds the biggest percentage gainers and losers among cryptocurrencies in the top 100 by market cap. Pass a timeframe such as 7d to change the period. CX Codex +1 ★ 3,990repo stars question Answers questions about a project's layout and docs without touching any files. Use it to get your bearings in a repo. CX Codex +1 ★ 3,990repo stars validator The validator subagent checks a task against its acceptance criteria and reports issues. Run it after a builder agent finishes its work. CX Codex ★ 3,990repo stars builder builder — a focused subagent that takes one task and completes it: writes code, creates files, runs commands. Works solo without coordinating other agents. CX Codex ★ 3,990repo stars work-completion-summary work-completion-summary delivers audio debriefs and next steps via ElevenLabs voice synthesis after completing a task. Useful for hands-free progress updates. CX Codex ★ 3,990repo stars crypto_market_agent_prompt The crypto_market_agent_prompt command gathers current figures for leading cryptocurrencies and lays them out in a market table. Use it for a compact price and volume snapshot. CX Codex +1 ★ 3,990repo stars

Project sponsors

Companies that keep this analytics open