setup

Activate the Lumira statusline by writing statusLine.command into Claude Code settings.

1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/cativo23/lumira --skill setup-cativo23
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: setup
Source: https://github.com/cativo23/lumira/tree/main/skills/setup
Command: npx skills add https://github.com/cativo23/lumira --skill setup-cativo23

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you turn on the lumira statusline after installing the Claude Code plugin by writing the correct statusLine.command into your Claude settings and creating a safe default config when needed.

Core Features & Use Cases

  • Plugin activation: Locates the installed lumira plugin cache and points Claude Code to the bundled binary.
  • Safe settings update: Merges only the statusLine.command field into settings.json without overwriting unrelated configuration.
  • First-run config bootstrap: Creates a default ~/.config/lumira/config.json only if it does not already exist.
  • Use case: After installing lumira from the marketplace, use this Skill to finish setup and make the statusline appear in Claude Code.

Quick Start

Ask the assistant to activate lumira for your Claude Code installation and write the status line command for you.

Frequently Asked Questions about setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I activate the Lumira statusline in Claude Code?

Activating the Lumira statusline involves locating the installed plugin cache and writing the correct statusLine.command into your Claude Code settings file. This skill safely merges the configuration so the statusline appears immediately after plugin installation.

How do I safely merge a statusLine command into settings.json without losing existing configuration?

Safely merging a statusLine command into settings.json requires updating only the target field while preserving unrelated configuration. This skill performs a safe JSON merge to ensure existing user settings remain completely intact during the plugin activation process.

Do I need to manually create a Lumira config file before using the statusline?

You do not need to manually create a Lumira config file before using the statusline. This skill handles first-run config bootstrap by creating a default ~/.config/lumira/config.json automatically only if it does not already exist on your system.

What happens if my Claude Code settings file is missing or invalid during plugin setup?

If your settings file is missing or invalid during plugin setup, this skill handles the error gracefully by managing the file state safely. It verifies the bundled binary and ensures settings are written correctly without overwriting valid user data.

Can I use this setup skill to configure a Claude Code plugin I installed from the marketplace?

You can use this setup skill to configure a Claude Code plugin installed from the marketplace. It is specifically designed for post-install setup workflows, locating installed plugin metadata and applying the necessary statusline activation commands.

Why is my Lumira statusline not showing up after installing the plugin?

Your Lumira statusline might not show up because the statusLine.command is not set in your Claude Code settings. This setup skill resolves the issue by locating the plugin binary and writing the correct configuration to initialize the display.