Code Spaceship Statusline Blueprint

Navigate through space on your coding journey with fuel tracking, warp levels, and star field displays.

When to Use This Setting

Apply this setting when you need to:

• Gamify your development sessions with a space exploration theme that tracks coding momentum
• Monitor session length through the distance and warp level counters that increase with each interaction
• Add visual variety to your Claude Code experience with randomized star field backgrounds Consider alternatives when:
• You need a statusline focused on practical development information like git status or test results
• Your terminal does not support Unicode characters needed for the space-themed emoji display

Quick Start

Configuration

Copy
name: code-spaceship-statusline-blueprint
type: setting
category: statusline

Example Application

Copy
claude setting:apply code-spaceship-statusline-blueprint

Example Output

Setting applied. Changes:
- statusLine: Code Spaceship navigation display
- Displays: [Model] Ship | Warp N | Fuel% | Distance | Stars | Directory

Core Concepts

Spaceship Mechanics Overview

Aspect	Details
Fuel System	Starts at 100%, decreases by 1% per interaction, refills when empty
Warp Level	Increments each time fuel depletes to zero, representing coding marathon milestones
Distance	Increases by 5 light-years per interaction, tracking cumulative session progress
Ship Condition	Full fuel (>80%) shows rocket, low fuel (40-80%) shows UFO, emergency (<40%) shows SOS

Spaceship State Architecture

+---------------------------+
|  Session Cache             |
|  /tmp/spaceship_{session} |
|  [fuel] [distance] [warp] |
+---------------------------+
         |
         v
+---------------------------+
|  State Update             |
|  fuel -= 1                |
|  distance += 5            |
|  if fuel <= 0:            |
|    fuel = 100             |
|    warp += 1              |
+---------------------------+
         |
    +----+----+----+
    |    |    |    |
    v    v    v    v
  Ship  Warp Fuel Stars
  Icon  Lvl  %    Random
         |
         v
+---------------------------+
| [Model] Ship Warp N |     |
| Fuel% | Distance | Stars  |
+---------------------------+

Configuration

Parameter	Type	Default	Description
statusLine.type	string	"command"	Status line type using shell command for dynamic content
statusLine.command	string	N/A	Bash script managing spaceship state with session-based caching
Fuel Decrement	number	1	Percentage of fuel consumed per interaction
Distance Increment	number	5	Light-years traveled per interaction
Cache Location	string	"/tmp/spaceship_*"	Temp path for session-persistent spaceship state

Best Practices

1. Use warp level as a session length indicator - Each warp level represents 100 interactions. High warp levels suggest long sessions where context compaction or a fresh start may be beneficial.
2. Monitor fuel for break reminders - When the ship enters emergency mode below 40% fuel, consider taking a break. The fuel cycle provides natural pacing for long development sessions.
3. Customize the star field for variety - The randomized star field adds visual interest. You can modify the star character set to include additional space-themed characters.
4. Reset state for new projects - The spaceship state persists per session ID. Starting a new Claude Code session automatically creates a fresh spaceship with full fuel.
5. Combine with practical statuslines - The spaceship display is purely for fun. For production work, consider using it alongside a secondary statusline that provides git and project information.

Common Issues

1. State file not created - The cache file at /tmp/spaceship_{session} is created on first interaction. If it fails, check write permissions on the /tmp directory.
2. jq required for JSON parsing - The command parses session context JSON with jq. Install jq if you see parsing errors in the statusline output.
3. Emoji not rendering correctly - The ship condition icons require Unicode support. If your terminal shows question marks or boxes, switch to a terminal emulator with full Unicode and emoji support.