hub / github.com/bobvibes/Clavix

github.com/bobvibes/Clavix @v7.3.0

Chat with this repo

repository ↗ · DeepWiki ↗ · release v7.3.0 ↗ · + Follow

469 symbols 1,391 edges 121 files 142 documented · 30%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

Clavix

Agentic prompt workflows as skills. Works with any agentskills.io compatible AI tool.

Install

npm install -g clavix
clavix init

Select Agent Skills during setup. Choose global (~/.config/agents/skills/) or project (.skills/) scope.

Skills

Skill	Purpose
`clavix-improve`	Optimize prompts with 6-dimension quality assessment
`clavix-prd`	Generate PRD through strategic questions
`clavix-plan`	Create task breakdown from PRD
`clavix-implement`	Execute tasks with progress tracking
`clavix-start`	Begin conversational exploration
`clavix-summarize`	Extract requirements from conversation
`clavix-refine`	Update existing PRD or prompt
`clavix-verify`	Verify implementation against requirements
`clavix-review`	Review PRs with criteria presets
`clavix-archive`	Archive completed projects

Workflows

Quick:      clavix-improve → clavix-implement
Full:       clavix-prd → clavix-plan → clavix-implement → clavix-verify
Exploratory: clavix-start → clavix-summarize → clavix-plan

How It Works

You run clavix init – Skills are installed as directories with SKILL.md files
You invoke a skill – Your AI tool loads the skill instructions
The agent follows the workflow – Using its native tools
Outputs saved locally – Under .clavix/outputs/

No code executes during skill invocation. The markdown templates ARE the product.

Other Integrations

Clavix also supports tool-specific integrations for tools that don't yet support Agent Skills:

Category	Tools
IDEs	Cursor, Windsurf, Kilocode, Roocode, Cline, GitHub Copilot
CLI agents	Claude Code, Gemini CLI, Qwen, Droid, CodeBuddy, OpenCode, LLXPRT, Amp, Crush, Codex, Augment, Vibe
Universal	AGENTS.md, OCTO.md, WARP.md

Run clavix init and select your tools. Command format varies by tool: - CLI tools (Claude Code, Gemini): /clavix:improve - IDE extensions (Cursor, Copilot): /clavix-improve

CLI Commands

Command	Purpose
`clavix init`	Initialize or reconfigure integrations
`clavix update`	Regenerate templates
`clavix diagnose`	Check installation health
`clavix version`	Show version

Docs

Requirements

Node.js >= 18.0.0
An AI coding tool

License

Apache-2.0

Star History

Extension points exported contracts — how you extend this code

NodeJSError (Interface)

* Interface for NodeJS errors with code property

src/utils/error-utils.ts

IntegrationConfig (Interface)

* Integration configuration from JSON

src/core/adapter-registry.ts

ClavixConfig (Interface)

(no doc)

src/types/config.ts

DiagnoseResult (Interface)

(no doc)

src/cli/commands/diagnose.ts

ValidationResult (Interface)

(no doc)

scripts/validate-consistency.ts

CommandResult (Interface)

(no doc)

tests/helpers/command-test-utils.ts

IntegrationConfig (Interface)

(no doc)

tests/consistency/integration-config.test.ts

OclifError (Interface)

* OCLIF error structure for CLI errors

src/utils/error-utils.ts

Core symbols most depended-on inside this repo

readFile

called by 221

src/utils/file-system.ts

ensureDir

called by 154

src/utils/file-system.ts

injectBlock

called by 80

src/core/doc-injector.ts

remove

called by 67

src/utils/file-system.ts

generate

called by 67

src/core/adapters/warp-md-generator.ts

src/utils/file-system.ts

generateCommands

called by 41

src/types/agent.ts

Shape

Function 175

Method 175

Class 70

Interface 49

Languages

TypeScript100%

Modules by API surface

tests/helpers/factories/mock-factory.ts26 symbols

tests/helpers/command-test-utils.ts22 symbols

src/utils/agent-error-messages.ts21 symbols

src/core/adapters/agent-skills-adapter.ts18 symbols

src/core/template-assembler.ts17 symbols

tests/helpers/cli-helpers.ts15 symbols

src/types/errors.ts15 symbols

src/utils/file-system.ts14 symbols

src/core/adapters/universal-adapter.ts14 symbols

scripts/validate-consistency.ts13 symbols

src/types/agent.ts12 symbols

src/core/doc-injector.ts12 symbols

For agents

$ claude mcp add Clavix \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact