nutshell — Task Packaging for AI Agents

What it does

Nutshell defines a portable bundle format (.nut) and provides a CLI to pack, inspect, validate, and publish structured task bundles containing manifests, context files, credentials, and acceptance criteria. It enables reliable handoffs between humans and agents and supports programmatic inspection and CI validation.

When to use it

Use nutshell when you need deterministic task handoff, archival of execution logs and artifacts, or trusted delivery/verification of agent work. It is valuable in workflows that require clear acceptance criteria, credential handling, or repeatable CI-based validation.

What's included

• Scripts: the project ships a cross-platform CLI with commands to init, pack, inspect, validate, publish, and serve bundles (has_scripts=false in fetch metadata but full CLI is described).
• References: links to the spec and example layouts; schemas and manifest conventions are documented in the SKILL.md.
• Instructions: step-by-step CLI usage (install, smoke test, init, pack, unpack, publish) plus manifest layout and typical workflows for publishers and executors.

Compatible agents

Works with agents able to run installed CLIs or call the binary (Linux/macOS/Windows). Useful for agents orchestrating multi-step tasks, CI pipelines, and cross-agent handoffs (ClawNet integrations possible).