{"name":"--name","slug":"name","family":"cli","title":"CLI flags","noun":"CLI flag","description":"Set a display name for the session, shown in `\/resume` and the terminal title. You can resume a named session with `claude --resume <name>`. In an interactive session, if another live session on this machine already uses the name, Claude Code applies [a variant of it](\/docs\/en\/sessions#name-your-sessions) instead. <br \/><br \/>[`\/rename`](\/docs\/en\/commands) changes the name mid-session and also shows it on the prompt bar","description_source":"docs","described_by":{"doc":"claude-code\/cli-reference","title":"CLI reference"},"presence":{"first_seen":"2.1.138","removed_in":null,"in_current_build":true,"newest_mined":"2.1.308","builds":149,"mined_builds":149,"first_cited":{"version":"2.1.221","released_at":"2026-08-03 22:16:25","spans":1}},"aliases":["-n"],"entries":[{"version":"2.1.299","anchor":"short-flag-normalisation-n-becomes-name","heading":"Option values that start with a dash are now kept attached to their option","line":"When Claude Code passes options on, a value starting with a dash is joined with `=`, and `-n` is written out as `--name`","released_at":"2026-10-14 00:23:19","reason":"found in this entry's text, named in this entry"},{"version":"2.1.290","anchor":"spawned-teammates-now-get-proactivity-passed-through","heading":"Teammates now inherit the lead session's proactivity level","line":"Teammates started by a lead session now receive `--proactivity` with the lead's level when one is set","released_at":"2026-10-05 18:12:44","reason":"found in this entry's text"},{"version":"2.1.283","anchor":"claude-daemon-help-lists-remote-control-listaddremove-subc","heading":"Help for claude daemon lists commands to manage Remote Control servers","line":"`claude daemon` help can now list `remote-control list`, `add` and `remove`, and worker status reports the folder being served","released_at":"2026-09-25 18:46:11","reason":"found in this entry's text"},{"version":"2.1.246","anchor":"background-workers-are-launched-with-a-name","heading":"Background workers are launched with a name","line":"Background workers are spawned with a --name argument identifying them.","released_at":"2026-08-25 19:17:34","reason":"named in this entry, found in this entry's text"},{"version":"2.1.232","anchor":"background-session-names-can-be-marked-as-chosen-to-avoid-a-","heading":"Background session names can be marked as chosen to avoid a collision","line":"Background session names auto-changed to dodge collisions now survive respawn like ones you chose.","released_at":"2026-08-13 21:30:53","reason":"named in this entry, found in this entry's text"},{"version":"2.1.224","anchor":"server-supplied-cli-arguments-are-validated-on-self-hosted-r","heading":"Server-supplied CLI arguments are validated on self-hosted runners","line":"Self-hosted runners now reject malformed or blocklisted CLI arguments handed down by the server.","released_at":"2026-08-07 01:36:32","reason":"found in this entry's text"},{"version":"2.1.223","anchor":"cloud-sessions-started-with-a-title-rename-themselves-instea","heading":"Cloud sessions started with a title rename themselves instead of auto-titling","line":"Cloud sessions you start with --name keep that name instead of being overwritten by a generated title.","released_at":"2026-08-05 22:51:13","reason":"named in this entry, found in this entry's text"},{"version":"2.1.221","anchor":"background-session-names-starting-with-survive-respawn","heading":"Background session names starting with \"-\" survive respawn","line":"Background sessions renamed to something starting with a dash now restart correctly.","released_at":"2026-08-03 22:16:25","reason":"named in this entry, found in this entry's text"},{"version":"2.1.221","anchor":"session-titles-are-normalised-and-blank-titles-rejected","heading":"Session titles are normalised and blank titles rejected","line":"Session titles are trimmed and cleaned, and blank ones are simply ignored instead of set.","released_at":"2026-08-03 22:16:25","reason":"named in this entry, found in this entry's text"},{"version":"2.1.66","anchor":"remote-control-simplified","heading":"Remote Control Simplified","line":null,"released_at":"2026-03-04 00:19:58","reason":"found in this entry's text"}],"entries_total":10,"docs":[{"source":"claude-code","path":"cli-reference","title":"CLI reference","documented":true},{"source":"api","path":"agents-and-tools\/mcp-tunnels\/deploy-helm","title":"deploy-helm","documented":false},{"source":"api","path":"cli-sdks-libraries\/cli\/using","title":"using","documented":false},{"source":"api","path":"manage-claude\/admin-api","title":"admin-api","documented":false},{"source":"api","path":"manage-claude\/cmek-azure-key-vault","title":"cmek-azure-key-vault","documented":false},{"source":"api","path":"manage-claude\/organization-webhooks","title":"organization-webhooks","documented":false},{"source":"api","path":"manage-claude\/user-management","title":"user-management","documented":false},{"source":"api","path":"manage-claude\/user-profiles","title":"user-profiles","documented":false},{"source":"api","path":"manage-claude\/wif-admin-api","title":"wif-admin-api","documented":false},{"source":"api","path":"manage-claude\/wif-providers\/aws","title":"aws","documented":false}],"docs_total":13,"gates":[],"related":[],"url":"https:\/\/changelogs.core-directive.com\/reference\/cli\/name","family_url":"https:\/\/changelogs.core-directive.com\/reference\/cli.json"}