hyphn

Share agents, commands & skills between AI tools

The unified bridge for AI coding assistants. Share your custom agents, commands, and skills across OpenCode and Claude Code without duplicating configuration.

⚡ Get Started View Source

1 $ hyphn init

Initialized ~/.hyphn structure
Created default configuration
Added example assets

2 $ hyphn setup

Configured OpenCode integration
Configured Claude Code integration
Ready to share assets

3 $ hyphn sources add ~/team-hyphn

Added source: team-hyphn
Loaded 3 agents, 5 commands, 2 skills

4 $ hyphn list

• @agent-review (team-hyphn)
• @skill-deploy (system)
• /test-suite (team-hyphn)

Unified AI Configuration

Write once, use everywhere. Hyphn standardizes your AI assistant capabilities.

🔄

Cross-Platform Sharing

Define agents and skills once in your ~/.hyphn directory and use them in both OpenCode and Claude Code.

👥

Team Sources

Add shared repositories as sources to instantly distribute custom agents and workflows to your entire team.

🔌

MCP Integration

Native support for Model Context Protocol. Expose your Hyphn tools as an MCP server for Claude Desktop.

🛠️

Skill Management

Organize reusable capabilities into skills that any agent can adopt. Specific instructions, prompt templates, and tool definitions.

🛡️

Safety Features

Automatic backups before overwrites, preservation of runtime data, and confirmation prompts for destructive operations.

📝

Configuration Management

Flexible initialization with force, minimal, and JSON modes. Supports multiple source paths and environment variable overrides.

hyphn init

Initialize ~/.hyphn/ directory structure

⚡

Default Initialization

# First-time initialization hyphn init

Creates complete structure with examples

🔄

Force Reinitialization

# Reinitialize (creates backup first) hyphn init --force # Skip confirmation prompts hyphn init --force --yes

Backs up existing config before overwriting

📦

Minimal Structure

# Create minimal structure (no examples) hyphn init --minimal # JSON output mode hyphn init --json

For scripting or custom setups

Safety Features

Protect your configuration and data

💾

Automatic Backups

Running init without --force on an existing installation safely exits with an error. With --force, a backup is created before overwriting.

~/.hyphn/backups/config-{timestamp}/

🔒

Data Preservation

User data in runtime directories (history/, cache/, logs/) is preserved during reinitialization.

✅

Confirmation Prompts

Destructive operations require user confirmation unless --yes or --json flag is specified.

📂

Complete Backups

Backups include configuration files, agents, commands, skills, hooks, and .gitignore settings.

Installation

Get up and running in seconds

📦

NPM Package

npm install -g @fwdslsh/hyphn

Install globally to use CLI anywhere

⚡

Quick Start

hyphn init hyphn setup

Initialize your local configuration and link to supported tools

👥

Team Setup

hyphn sources add ~/team-hyphn hyphn sources add /shared/company

Add shared repositories to distribute assets

Commands

Complete CLI reference

hyphn init              # Create ~/.hyphn/ with examples
hyphn init --force     # Overwrite existing configuration (creates backup)
hyphn init --minimal    # Create minimal structure without examples
hyphn init --json       # JSON output mode (skips prompts)

hyphn setup             # Configure OpenCode and Claude Code
hyphn serve             # Start MCP server (for Claude Code)
hyphn list              # List all loaded assets
hyphn sources           # Show configured sources
hyphn sources add PATH  # Add a source directory
hyphn sources rm PATH   # Remove a source directory
hyphn validate          # Check assets for errors
hyphn help              # Show help

Environment Variables

Configure behavior with environment variables

HYPHN_HOME Primary directory (default: ~/.hyphn)

HYPHN_PATH Additional sources (colon-separated)

Supported Platforms

Hyphn bridges the gap between your favorite AI tools

💻

OpenCode

Full native integration. Hyphn manages your opencode.json and extension loading.

🤖

Claude Code

Injects custom slash commands and prompts directly into your Claude Code sessions.

🖥️

Claude Desktop

MCP server support exposes Hyphn tools via Model Context Protocol.

Ready to Unify Your AI Workflow?

🚀 Getting Started Guide 📚 View Documentation 📚 View Examples