Skip to content

elixpo/claudeOps.elixpo

Repository files navigation

ClaudeOps

ClaudeOps

Make Claude Code actually work like a senior engineer.
Drop-in agents, automatic token compression, safety hooks, and a UI design pipeline — one command to install.

npm Downloads Stars License Platform


The Problem

Claude Code is powerful, but out of the box it burns through tokens reading things it doesn't need, skips code review, writes orphan files nobody calls, and produces generic-looking UIs. You end up babysitting it.

ClaudeOps fixes that. It's a set of config files, agents, and hooks that drop into your Claude Code setup and make it work the way you'd expect a senior engineer to work — research before coding, review before merging, prove things work before saying "done."


ClaudeOps


Quick Start

npx @elixpo/claudeops init

That's it. The installer walks you through each component — nothing gets installed without your say-so.

Other commands:

npx @elixpo/claudeops status    # see what's installed
npx @elixpo/claudeops remove    # clean uninstall

Flags:

npx @elixpo/claudeops init --yes          # skip all prompts, install everything
npx @elixpo/claudeops init --agents-only  # only install the 15 agents
npx @elixpo/claudeops init --no-mcp       # skip MCP server setup

What's Inside

Agents

15 specialized agents that Claude auto-delegates to based on what you're doing. They live in ~/.claude/agents/ and cost zero tokens when they're not active.

Security & Review

Agent What it does
breaker Tries to break your code. Every issue comes with a concrete exploit, not a vague warning.
red-team You tell it what security measures you added. It attacks those specific assumptions.
refiner Multi-pass review: write, critique against 6 principles, rewrite, verify. Two modes — quick surgical or full systematic.
prism 4 isolated review passes (security, performance, test coverage, correctness), each with blinders so nothing gets glossed over.
test-auditor Catches fake tests — mocks that test nothing, assertions that always pass, happy-path-only coverage.

Planning & Design

Agent What it does
architect System design and ADRs. Compares 3+ approaches before recommending. Never writes implementation code.
brancher Forces exploration of multiple solutions before committing. Won't start coding until all branches are compared.
questioner 6 mandatory questions before any code. Surfaces hidden assumptions and finds the simplest path.
specwriter Interviews you through 5 rounds of questions, then produces a SPEC.md detailed enough for a fresh session to execute without follow-ups.
judge Evaluates competing solutions through binary gates and weighted scoring. Picks a winner, never declares a tie.

Research & Integration

Agent What it does
researcher 7 depth levels from surface (30 seconds) to overkill (unlimited). Launches parallel sub-agents at higher levels.
fuzzer Property-based testing across 1000+ random inputs. Finds edge cases humans miss.
wirer Verifies new code is actually wired into the running system. Catches the #1 AI coding failure: beautiful code that nothing calls.

UI & Frontend

Agent What it does
ui-architect Auto-triggers on frontend tasks. Pulls from component libraries (shadcn, magicui, animotion) instead of writing from scratch. Handles responsive, dark mode, accessibility.
design-critic Auto-runs after UI implementation. Scores visual quality 1-10 with specific fix suggestions.

Token Savings

These tools run automatically after setup — they intercept Claude's input and output and compress what doesn't need to be verbose.

Tool What it does Savings
RTK by rtk-ai Compresses bash command output, auto-rewrites git, ls, cat, test runners, and 100+ more 60-90%
jCodeMunch Lightweight code indexing via tree-sitter 95%+
Context Mode Sandboxes tool outputs in SQLite instead of dumping them into context 98%
MCP Compressor Compresses MCP server responses 70-95%
Cozempic Auto-prunes stale context at multiple thresholds 30-70%
Headroom AST-aware prompt compression ~50%
Serena LSP-powered code navigation (40+ languages) Significant
Docfork 9000+ library docs served on demand Moderate

The installer asks before adding each one. Everything is optional.

UI Component Libraries

If you do frontend work, ClaudeOps connects Claude to real component registries so it fetches production components instead of hallucinating them.

Library What you get
21st.dev Magic AI-generated production components
shadcn/ui Official registry, zero hallucinations
Magic UI 60+ animated components
Animotion 745 CSS animations, 9000 SVG icons
Aceternity UI 200+ cinematic and 3D components
Glance Browser screenshots — Claude sees what it built

21st.dev needs a free API key from 21st.dev. The installer reminds you.

Safety Hooks

These run deterministically on every session — no LLM involved, just bash and regex.

What it catches When
Secrets in prompts or files (AWS, GitHub, Stripe, SSH keys, JWTs, and more) Before every prompt and file write
Destructive commands (rm -rf, git reset --hard, DROP TABLE, git clean -f, etc.) Before every bash command
--no-verify on git commits Before git commits
Commits to main/master Before git commits (warning, not blocking)
Orphan files with zero import references On file edits and session end
Stuck loops (3+ identical failures) After bash commands
Session continuity Writes HANDOVER.md on exit, reads it on next session start

Per-Project Setup

After the global install, each project just needs a .claudeignore file (a template is included) to keep Claude from reading node_modules/, dist/, and other noise. Code indexing happens automatically on first visit.


How It Works

The approach is simple: use Claude Code's own extension points (agents, hooks, MCP servers, plugins) to make Claude behave better by default.

  • Agents over instructions — a specialized agent that loads on-demand costs zero tokens when unused. A rule in CLAUDE.md costs tokens every single turn.
  • Hooks over suggestions — a PreToolUse hook that blocks a destructive command is stronger than a polite instruction Claude might ignore.
  • Evidence over assertions — every verification requires proof (test output, type checker results), not "this should work."
  • Autonomous over manual — tools that intercept and optimize automatically beat workflows that depend on you remembering to invoke them.

Uninstall

npx @elixpo/claudeops remove

Interactively removes agents, hooks, MCP servers, and plugins. Your non-ClaudeOps configuration is preserved.


Credits

ClaudeOps bundles and configures tools built by the wider Claude Code community. Full credit to their authors — ClaudeOps just wires them into a single install flow.

Contributing

PRs welcome. Areas where help is needed:

  • New agents for specific domains (ML, mobile, embedded)
  • Benchmarks comparing with/without ClaudeOps
  • Platform-specific install improvements


Built with ❤️ and maintained by @elixpo

github-snake

Packages

 
 
 

Contributors