Set descriptive names for Aura HUD session display
Set descriptive session names in the Aura HUD to help users track what each session is working on.
aura set-name "<name>"
Aura does not read aura set-name ... from arbitrary terminals. The HUD name updates only when Aura observes this command inside an agent event stream.
Bash tool (hooks capture tool_input.command).exec_command tool (it appears in the rollout JSONL).If you run aura set-name ... in another terminal, you'll see local stdout but the HUD will not change.
The session name should describe what we're trying to accomplish. For larger tasks with distinct phases, use Task - Step format.
Use Task - Step format when:
| Rule | Good | Bad |
|---|---|---|
| 2-6 words | "Fix Login Auth Flow" | "Fix the authentication bug in the login system" |
| Start with verb | "Add Export" | "Export Feature" |
| No filler words | "Refactor API" | "Refactor the API Layer" |
| No paths/files | "Update Config" | "Update src/config.ts" |
| No jargon | "Speed Up Search" | "Optimize O(n^2)" |
| User Request | Session Name |
|---|---|
| "Fix the bug where login fails" | "Fix Login" |
| "Add a button to export data" | "Add Export" |
| "Refactor the authentication code" | "Refactor Auth" |
| "Add dark mode to the app" | "Add Dark Mode" |
| "Help me understand this code" | (don't set) |
| "Run the tests" | (don't set) |
| Large feature with phases | "Add Auth - Design" -> "Add Auth - Implement" -> "Add Auth - Test" |
Fix [Thing] -> "Fix Login", "Fix Cart"Add [Thing] -> "Add Export", "Add Dark Mode"Refactor [Area] -> "Refactor Auth", "Refactor API"Update [Thing] -> "Update Deps", "Update Config"[Task] - [Step] -> "Add Auth - Design", "Add Auth - Implement", "Add Auth - Test"