Add ncc utility skill: host operational and health CLI#2971
Open
zivisaiah wants to merge 1 commit into
Open
Conversation
ncc is a host-side operational and health CLI, a sibling to ncl. It covers what ncl does not: host service lifecycle (launchd on macOS, systemd --user on Linux, auto-detected), a component health scan (exit 2 on hard fail), and visibility into scheduled/cron tasks. Standalone Python 3 stdlib script, so it works even when the host service is down; reads the SQLite DBs directly and shells to launchctl/systemctl/docker. Mirrors ncl's UX (subcommands, --json, table output, exit codes).
This was referenced Jul 8, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Type of Change
.claude/skills/<name>/, no source changes)Description
Adds
ncc(NanoClaw Control), a host-side operational and health CLI, as a sibling toncl. Wherencldoes central-DB entity CRUD (agent groups, wirings, roles),ncccovers the operational surfacencldoes not: host service lifecycle, a component health scan, and visibility into scheduled work.Why. There is no shipped tool for host service control or health inspection. Service management is documented only as raw
launchctl/systemctlcommands, and/debugis instruction-only with no executable scanner.nccfills that gap.How it works. A standalone Python 3 script (standard library only). It reads the session and central SQLite DBs directly and shells out to
launchctl/systemctl/docker, so it keeps working even when the host service is down, which is whenhealthandservice startmatter most. Cross-platform: launchd on macOS, systemd (--user) on Linux, both auto-detected (the unit is discovered, not hardcoded). It mirrorsncl's UX: subcommands,--json, table output, exit codes.Commands:
ncc service status|start|stop|restartncc health [--json]scans the service, Docker daemon, central DB integrity, host disk, the OneCLI gateway, each agent container (autocompact thrashing, zombie processes, heartbeat freshness), recent permanent delivery failures, and overdue scheduled tasks. Exits 2 on a hard FAIL, 0 otherwise (WARN is advisory).ncc tasks [--json]running containers plus pending ad-hoc tasksncc crons [--json]recurring scheduled tasksncc --version,ncc --help,ncc <command> --helpHow it was tested. Installed via the SKILL.md steps on macOS (launchd) against a live install and exercised every subcommand, confirmed the
--jsonoutput parses, and verified the health exit codes (0 on OK/WARN, 2 on FAIL) and that the symlinked binary resolves the checkout from any working directory. The Linux/systemd path was validated in a Python 3.12 Linux container: platform detection, unit discovery, status parsing, correctsystemctlinvocation, and the SQLite/disk/heartbeat reads. Real-daemon validation on a live systemd host is still pending. On Linux the service is asystemctl --userunit, sonccmust be run as the service's owning user; this is documented in the skill's troubleshooting.Usage.
ncc health,ncc service restart,ncc crons --json. Install steps are in the SKILL.md.For Skills