just-claude

Automatically expose just recipes as Claude Code skills.

This enables human devs and Claude to share a common toolset:

Installation

npm install -g just-claude

Then, in your project, run:

just-claude init

This will install a hook which will automatically make any just recipes available to Claude via Claude Agent Skills, and keep them synchronized (via a Claude session hook).

Requirements

• Node.js 18+
• just command runner
• Claude Code

Quick Start

# Install
npm install -g just-claude

# Create a new project
mkdir my-project && cd my-project

# Create a simple justfile with a documented recipe
cat > justfile << 'EOF'
# Say hello (this comment becomes the recipe description)
hello name="world":
    echo "Hello, {{name}}!"
EOF

just-claude init

This will modify your Claude settings file, while retaining a backup. The generated skill files can be gitignored.

Other commands

# Check what was installed
just-claude status

# Output:
# just command: ✓ available
# justfile: ✓ found
# public recipes: 1
# generated skills: 1
# hook configured: ✓ yes

# See what skills were created
just-claude list

# Output:
# Generated skills:
#   - just-hello

# Check a generated skill
cat .claude/skills/just-hello/SKILL.md

# Remove hook and generated skills
just-claude clean

Develop / Install from Source

# Clone and build locally
git clone https://github.com/yourusername/just-claude.git
cd just-claude
npm install
npm test

# Install the CLI globally from source
npm install -g .

# Wire up a project (from inside the target repo)
just-claude init

Contributing

See CONTRIBUTING.md for development setup and guidelines.

License

MIT