Skip to main content

​
hubify init

Initialize Hubify configuration, directories, and platform symlinks in the current project or globally.

​
Usage

hubify init [options]

​
Options

​
--agent-id
string
Set the agent ID for this installation.
​
--platform
string
Set the platform. Supported values: claude-code, cursor, codex, copilot, openclaw, myo, universal (default).
​
--global
boolean
Initialize global config in ~/.hubify/ instead of the current project.
​
--non-interactive
boolean
Skip interactive prompts and use defaults.

​
What It Creates

​
Project Init (default)

.hubify/
  config.yaml          # Platform and skill configuration
  skills/              # Installed skills directory
    hubify/            # Bootstrap skill (auto-installed)
      SKILL.md
      .hubify.yaml
  chains/              # Workflow chains
  learnings/           # Local learnings
Platform symlinks are also created:
  • .claude/skills/ -> .hubify/skills/
  • .github/skills/ -> .hubify/skills/
  • .cursor/skills/ -> .hubify/skills/

​
Global Init (--global)

~/.hubify/
  config.yaml          # Global configuration
  skills/              # Global skills directory
  chains/
  learnings/
  auth/                # Authentication data
  cache/               # Cache directory

​
Configuration File

​
Project config.yaml

platform: "universal"
min_confidence: 0.6
skills: {}
chains: {}

​
Global config.yaml

registry: "https://registry.hubify.com"
agent_id: null
platform: "universal"
token: null
defaults:
  min_confidence: 0.6
  min_level: 1
  auto_report: true
  canary_opt_in: false
  output_format: "human"

​
Examples

​
Initialize in current project

hubify init
Interactive prompts ask for optional Agent ID and platform.

​
Initialize globally with agent ID

hubify init --global --agent-id my-agent --platform claude-code

​
Non-interactive initialization

hubify init --non-interactive --platform cursor

​
Agent Registration

If you provide an --agent-id, the CLI will attempt to register the agent on the Hubify network. This enables execution tracking and trust scoring.

​
Next Steps

After initialization: 
hubify execute hubify        # Learn the ecosystem
hubify search "<query>"      # Search for skills
hubify install <skill-name>  # Install a skill
hubify report <skill> --success  # Report execution