How noureldinshobier/claude-tuning works
claude-tuning is a Claude Code configuration and plugin bundle. Its main workflow is a user running tune: setup checks prerequisites, installs pinned plugins and tools, and merges recommended settings and rules into the user’s Claude configuration. During later Claude Code turns, hooks can assemble available skills and suggest one, or route eligible coding-agent tasks to Opus using TypeSafe Jev. The README also documents installed shell compression, code-graph, search, and compaction capabilities. Hook wiring beyond the shown code is documented rather than inspected in full.
Main entry points: setup.ts Setup command · suggest.ts Skill suggestions · upstreams.ts stash search · jev.ts Jev client
Components 19
Setup
- Setup command
src/setup.ts - Settings and rules
src/settings.ts
Runtime hooks
- Skill suggestions
src/suggest.ts - Skill roster
src/roster.ts - Built-in skills
src/builtins.ts - Model routing
src/route-model.ts - Jev client
src/jev.ts
Pinned components
- Upstream catalog
src/upstreams.ts - stash search
src/upstreams.ts - Web search
src/upstreams.ts - ponytail
src/upstreams.ts - i-have-adhd
src/upstreams.ts - Fast compaction
src/upstreams.ts - rtk compression
src/upstreams.ts - Code graph
src/upstreams.ts
External services
- TypeSafe Jev
- Jina
Other components
- Claude Code user
- Claude Code
Connections 21
- Claude Code user → Setup command: runs setup
README.md - Setup command → Upstream catalog: reads pins
src/setup.ts - Setup command → Settings and rules: merges settings
src/setup.ts - Settings and rules → Claude Code: writes configuration
src/settings.ts - Setup command → stash search: installs plugin
README.md - Setup command → Web search: installs plugin
README.md - Setup command → ponytail: installs plugin
README.md - Setup command → i-have-adhd: installs plugin
README.md - Setup command → Fast compaction: installs plugin
README.md - Setup command → rtk compression: installs tool
README.md - Setup command → Code graph: installs tool
README.md - Claude Code → Skill suggestions: submits prompt
README.md - Skill suggestions → Skill roster: loads skills
src/suggest.ts - Skill roster → Built-in skills: adds built-ins
src/roster.ts - Skill suggestions → Jev client: asks for ranking
src/suggest.ts - Claude Code → Model routing: routes agent task
README.md - Model routing → Jev client: asks complexity
src/route-model.ts - Jev client → TypeSafe Jev: sends questions
src/jev.ts - stash search → TypeSafe Jev: ranks results
README.md - Web search → Jina: searches and reads
README.md - stash search → Jina: loads URLs
README.md