alignment-mode

Claude Plugins

A collection of plugins for Claude Code.

Installation

Add this repository as a marketplace:

/plugin marketplace add NiltonVolpato/claude-plugins

Then browse and install plugins via /plugin or install directly:

/plugin install <plugin-name>@nv-claude-plugins

Plugins

master-programmer

Channels ancient wisdom for modern programming dilemmas through parables and koans.

alignment-mode

Alignment mode: blocks write tools until you and the agent agree on the plan. Run /align to enter alignment mode, describe your task, iterate on the approach, then type LGTM or /lgtm to unlock execution. See the plugin README for details.

plan-mode

Plan management: create, approve, track, and resume implementation plans across sessions. Run /plan-mode:plan+ to create a plan, then /plan-mode:plan+approve to approve and start implementing. See the plugin README for details.

statusline

Event logging hooks for the statusline activity display. This plugin is a companion to the statusline CLI tool (see below).

Statusline

A customizable status line for Claude Code with modular components.

Quickstart

1. Install uv:

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

2. Install and configure:

   uvx --from git+https://github.com/NiltonVolpato/claude-plugins statusline install
   

   This installs the statusline command via uv tool install and configures Claude Code to use it. To update later:

   uv tool upgrade nv-claude-plugins
   

Preview

Test how the status line looks with sample data:

statusline preview

Available Modules

Module	Description	Example
model	Model display name	Opus 4.5
workspace	Current directory	my-project
git	Git branch and status	main*↑2
cost	Session cost	$0.01
context	Context window usage	42%
context_bar	Context as progress bar	[████ ] 42%
version	Claude Code version	v2.0.76

Themes

The statusline supports different themes:

# Nerd Font icons (default) - requires a Nerd Font
statusline preview --theme=nerd

# ASCII labels (no special fonts needed)
statusline preview --theme=ascii
# Output: Model: Opus 4.5 | Dir: my-project

# Emoji icons
statusline preview --theme=emoji
# Output: 🤖 Opus 4.5 | 📁 my-project

# Minimal (no labels)
statusline preview --theme=minimal

# Disable colors
statusline preview --no-color

Configuration

Create a config file at ~/.claude/statusline.toml:

statusline config --init

Example configuration:

# Global defaults
theme = "nerd"      # nerd | ascii | emoji | minimal
color = true
enabled = ["model", "workspace"]
separator = " | "

# Per-module overrides
[modules.model]
color = "cyan"
theme = "ascii"     # Override theme for this module only

# Custom theme variables per module
[modules.model.themes.nerd]
label = ""

[modules.model.themes.ascii]
label = "Model:"

Module Aliases

Display the same module multiple times with different configurations using aliases:

enabled = ["model", "ctx_percent", "ctx_tokens"]

[modules.ctx_percent]
type = "context"  # Use the "context" module
format = "[yellow]{{ context.used_percentage | format_percent }}[/yellow]"

[modules.ctx_tokens]
type = "context"  # Same module, different format
format = "[dim]{{ context.total_input_tokens }}/{{ context.context_window_size }}[/dim]"

The type field specifies which module class to use. If omitted, the config key itself is treated as the module type (backward compatible).

Customization

statusline render --modules=model,workspace,cost --separator=" :: "

For more options: statusline --help

License

MIT License - See LICENSE for details.