Skip to content
Development
Command

/explain-state

Override profile inference — pass an explicit profile name.

From plugin
nyann
741 skills41 commands3 hooks
> /plugin marketplace add thettwe/nyann
> /plugin install nyann@nyann-plugins

Command definition

explain-state.md
name: nyann:explain-state
description: >
  Print a read-only summary of what nyann sees: stack, profile, branching,
  hooks, CLAUDE.md status, recent commits.
arguments:
  - name: json
    description: Emit machine-readable JSON instead of a human-readable table.
    optional: true
  - name: profile
    description: Override profile inference — pass an explicit profile name.
    optional: true

**Plugin root:** This is a Claude Code plugin, NOT a CLI tool. Do NOT search via `which`, `npm list`, `pip list`, or `brew list`. This file is at `<plugin_root>/commands/`. All scripts: `<plugin_root>/bin/`. Read the matching `skills/*/SKILL.md` for the full flow.

/nyann:explain-state

Wraps `bin/explain-state.sh`. Read-only. Aggregates:

  • Stack detection (language, framework, package_manager, confidence)
  • Inferred profile (from CLAUDE.md or `--profile`)
  • Branching strategy + base branches (from profile)
  • Hook signals (husky / pre-commit.com / nyann core)
  • CLAUDE.md presence + size + router markers
  • 5 most recent commits

Use as a first-look diagnostic before `doctor` (audit) or `bootstrap-project` (setup/retrofit).

See `skills/explain-state/SKILL.md` for what to read back to the user.

@thettwe
Ships withnyann

ငြမ်း is Burmese for scaffolding. Nyann is the Claude Code plugin that picks expert git defaults for your stack — branching, working hooks (Husky / pre-commit.com / lefthook), commits, releases, CI, docs — then keeps the repo on those rails through every PR

Stars on GitHub

Momentum

stars in total
7
Star history of thettwe/nyann on GitHub, a chart by star-history.com

Other commands on nyann.

apply

apply

Command

Path to an IacPlan JSON from a prior /nyann:plan run, to apply the exact previewed plan.

@thettwe@thettweInstall Command
bootstrap

bootstrap

Command

Optional profile name to apply. If provided, skip stack detection's recommendation step and load this profile via…

@thettwe@thettweInstall Command
branch

branch

Command

The branch slug (feature/bugfix/hotfix) or version string (release).

@thettwe@thettweInstall Command
check-prereqs

check-prereqs

Command

If passed, emit the probe results as JSON instead of the human table.

@thettwe@thettweInstall Command
cleanup-branches

cleanup-branches

Command

Branch to use as the merge target. Defaults to the profile's primary base branch (auto-resolved through `origin/HEAD`, `main`, or…

@thettwe@thettweInstall Command

More commands from other plugins.

build
Auto-invoked

build

Command

Implement tasks incrementally — build, test, verify, commit. Add "auto" to run the whole plan in one approved pass.

@addyosmani@addyosmaniInstall Command