convez.ai
TemaProdutividadeIniciante
VasylRomanets

Spinpacks

VasylRomanets/spinpacks

Customize mensagens de carregamento do Claude Code com packs temáticos

Ver no GitHub
InicialPluginScore · de 0 a 100

Ferramenta CLI para instalar e gerenciar packs temáticos de mensagens de carregamento no Claude Code. Substitui ou estende as mensagens padrão de spinner com frases personalizadas de temas curados — atualmente inclui um pack com referências de The Office.

Instalação

$npx convez-ai VasylRomanets/spinpacks

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v1.3.0
Issues abertas
0
Contribuidores
1

Casos de uso

  • Personalizar experiência de geração de código no Claude Code
  • Instalar e gerenciar múltiplos packs de verbos temáticos
  • Criar ambiente mais leve durante esperas de processamento de IA

Veredito

Ferramenta de nicho bem implementada que melhora a experiência estética do Claude Code. Útil para quem quer personalizar o ambiente, mas com escopo limitado — serve apenas para cosmética de loading screens.

README

A tradução para o português deste README ainda está na fila.

Homebrew Formula Claude Code License: MIT

Apply themed spinner verb packs to Claude Code. Replace or extend the default loading messages with custom phrases from themed packs — currently ships with a The Office pack.

$ spinpacks install the-office
Installed 'the-office' in user scope — 230 verbs active

$ spinpacks sample the-office -n 3
Schruting it
Being Prison Mike
That's what she said

Installation

Homebrew (recommended)

brew tap vasylromanets/tap
brew install spinpacks

Manual

git clone https://github.com/vasylromanets/spinpacks.git
# Add the bin directory to your PATH, or symlink the executable:
ln -s "$(pwd)/spinpacks/bin/spinpacks" /usr/local/bin/spinpacks

Quick start

# See what packs are available
spinpacks list

# Install a pack into your user-wide Claude Code settings
spinpacks install the-office

# Preview verbs before installing
spinpacks sample the-office -n 5

# Check what's currently active
spinpacks status

# Remove a pack
spinpacks uninstall the-office

Usage

$ spinpacks help
Usage: spinpacks <command> [pack] [options]

Commands:
  list, ls                    List available packs (--installed filters to installed; -v shows verb count)
  install, add <pack>         Install a pack into Claude Code settings (merges with existing verbs)
  uninstall, remove [<pack>]  Remove a pack (or --all) from Claude Code settings
  update [<pack>]             Reinstall pack(s) (all tracked if no pack given)
  status                      Show active verbs, mode and tracked packs (--all shows every scope)
  mode [replace|append]       Get or set Claude Code's spinnerVerbs.mode
  sample <pack> [-n N]        Print N random verbs from a pack (default: 1)
  info, show <pack>           Show pack details and a sample of verbs (-v lists all)
  search <text>               Search packs by name, description, tags, or verb content (-v shows matching verbs)
  doctor                      Check for configuration problems
  version                     Print version
  completion <shell>          Generate shell completion (bash, zsh, fish)
  help [command]              Show help [for COMMAND]

Options:
  --scope SCOPE      Target scope: user (default), project, local, managed
  --force            Skip safety guards (remove untracked packs)
  --all              Operate on all tracked packs (uninstall/update) or all scopes (status)
  --installed        Filter list to only installed packs (--scope filters to one scope)
  --dry-run          Show what would change without writing anything
  -v, --verbose      Show detailed output
  -q, --quiet        Suppress non-error output (write commands only)
  --json             Output as JSON
  --no-color         Disable color output
  -n, --count COUNT  Number of verbs to sample
  -V, --version      Print version
  -h, --help         Show this help message

Environment:
  NO_COLOR           Disable color output when set (any value)
  CLAUDE_CONFIG_DIR  Override Claude Code's config directory (default: ~/.claude)

Run spinpacks help <command> for detailed usage of any command.

Scopes

spinpacks writes to Claude Code's settings files. The --scope flag controls which file is modified:

ScopeFileWhen to use
user (default)~/.claude/settings.jsonApplies to all your projects
project.claude/settings.jsonApplies to the current project (commit to share with team)
local.claude/settings.local.jsonPer-project, never committed
managed/Library/Application Support/ClaudeCode/managed-settings.jsonManaged/enterprise
# Install into the current project only
spinpacks install the-office --scope project

# See all scopes at once
spinpacks status --all

Shell completions

Homebrew users get completions installed automatically — no extra steps needed.

For manual installs, generate and install the completion script for your shell:

# zsh — add to fpath, then run compinit
spinpacks completion zsh > ~/.zsh/completions/_spinpacks

# bash — source in ~/.bashrc
spinpacks completion bash >> ~/.bashrc
source ~/.bashrc

# fish
spinpacks completion fish > ~/.config/fish/completions/spinpacks.fish

Pack format

A pack is a single JSON file in the packs directory. It is a JSON object with a required verbs array and optional metadata fields:

{
  "description": "A short description of the pack",
  "author": {
    "name": "Your Name",
    "url": "https://github.com/you"
  },
  "tags": ["category", "theme"],
  "verbs": [
    "Doing the thing",
    "Making it happen",
    "Crunching numbers"
  ]
}
FieldRequiredDescription
verbsYesArray of verb strings shown in Claude Code's spinner. Short phrases (2–6 words) look best.
descriptionNoOne-line summary shown by list -v and info
author.nameNoName of the person who created the pack
author.urlNoLink to the author's profile or homepage
tagsNoSearch keywords used by search; use spaces not hyphens (e.g. "the office", not "the-office")

Once the file is in the packs directory, run spinpacks install <name> to activate it.

Contributing

Contributions are welcome — new packs especially.

  1. Fork the repository
  2. Add packs/<name>.json following the pack format above
  3. Open a pull request

Please run spinpacks doctor before submitting to confirm your files are valid.

License

MIT — see LICENSE.

Copyright (c) 2026 Vasyl Romanets

Ver o original no GitHub

Bom para

Relacionados