v2.0 // ZERO_DEPS // OPEN_SOURCE

LIGHTWEIGHT HARNESS FOR
CLAUDE CODE

> Security hooks (0 tokens) + dev pipeline + smart defaults. Install in one command, save 85% token overhead_

VIEW_SOURCE QUICK_START

neural_claude_code v2.0.0

$ curl -fsSL .../install.sh | bash

[ok] 5 security hooks installed (0 tokens)

[ok] 9 skills: init, discover, spec, craft, vet, exercise, git-save, slop-scan, html

[ok] 5 compact rules (~135 tokens total)

[ok] outputStyle: concise

---

Token overhead: ~635/msg (down from ~4300)

Run /init to generate your CLAUDE.md_

TOTAL_FILES

~635

TOKENS/MESSAGE

DEPENDENCIES

SECURITY_HOOKS

> Bash scripts outside context. Zero token cost. They enforce, not guide._

DANGEROUS_ACTIONS_BLOCKER

Blocks rm -rf /, force push to main, DROP TABLE, npm publish.

PROMPT_INJECTION_DETECTOR

Detects role override attempts and manipulation patterns in real-time.

OUTPUT_SCANNER

Warns when API keys (Anthropic, OpenAI, AWS, GitHub, Stripe) appear in output.

SENSITIVE_FILE_GUARD

Blocks read/write to .env, credentials.json, SSH keys, .npmrc.

PRE_COMPACT

Saves git state and active plans before context compaction. Recoverable context.

DESIGN_PRINCIPLE

If behavior can be enforced with a hook (0 tokens), don't write a rule. Hooks enforce. Rules guide.

SKILLS

> On-demand tools. Zero tokens when idle. Load only when invoked._

/init

Auto-generate project CLAUDE.md

/discover

Surface unknowns before you plan

/spec

Plan a change into an approvable artifact

/craft

Build the approved plan, review, ship

/vet

Clean-context review: SHIP/HOLD/BLOCK

/exercise

Behavioral gate: drive the app as a user

/git-save

Conventional commits + safety

/slop-scan

Detect AI slop and tech debt

/html

PlanViewer / ResultViewer artifacts

INSTALLATION

> Get started in 3 commands_

ONE_COMMAND_INSTALL

1. Install everything

$ curl -fsSL https://raw.githubusercontent.com/brolag/neural-claude-code/main/install.sh | bash

2. Generate project CLAUDE.md

> /init

Installs 5 hooks, 9 skills, 5 rules. Merges into existing settings.json without overwriting.

OR_INSTALL_AS_PLUGIN

Native Claude Code plugin (hooks + skills)

> /plugin marketplace add brolag/neural-claude-code
> /plugin install neural@neural-claude-code

Skills namespaced as /neural:spec, /neural:craft, etc. Pick ONE install method — the plugin and the curl installer together double-fire the hooks. The plugin ships hooks + skills; the curl installer also adds the compact rules and CLAUDE.md template.

LIGHTWEIGHT HARNESS FORCLAUDE CODE