Plugins

Plugins extend hive with custom commands and status providers. Plugins auto-detect their dependencies at startup — if the required CLI tool is installed, the plugin activates automatically.

plugins:
  tmux:
    enabled: true
  claude:
    enabled: true
  github:
    enabled: true
    results_cache: 8m

Auto-detection

Most plugins auto-detect their dependencies at startup. You only need to set enabled: true — if the required CLI tool isn't installed, the plugin silently deactivates. No errors, no configuration needed.

Tmux Plugin

The tmux plugin provides default commands for session management using bundled scripts (hive-tmux, agent-send) that are auto-extracted to $HIVE_DATA_DIR/bin/.

plugins:
  tmux:
    enabled: true # true by default, set false to disable

Commands Provided

Command	Description	Default Key
`TmuxOpen`	Open/attach tmux session	`enter`
`TmuxStart`	Start tmux session (background)	—
`TmuxKill`	Kill tmux session	`ctrl+d`
`TmuxPopUp`	Popup tmux session	`o`
`AgentSend`	Send Enter to agent	`A`
`AgentSendClear`	Send /clear to agent	—

Claude Plugin

The Claude plugin provides Claude Code commands.

plugins:
  claude:
    enabled: true # auto-detected (requires `claude` CLI)

Commands Provided

Command	Description	Default Key
`ClaudeFork`	Fork Claude session in new window	—

Usage

# Add keybinding for fork
keybindings:
  f:
    cmd: ClaudeFork

# Or invoke via command palette
# :ClaudeFork

GitHub Plugin

The GitHub plugin provides PR status display and GitHub CLI commands. Auto-detected when gh CLI is installed.

plugins:
  github:
    enabled: true # auto-detected (requires `gh` CLI)
    results_cache: 8m # how often to refresh PR status (default: 8m)

Commands Provided

Command	Description	Default Key
`GithubOpenRepo`	Open repo in browser	—
`GithubOpenPR`	View current PR in browser	—
`GithubPRStatus`	Show PR status (popup)	—
`GithubPRCreate`	Create PR in browser	—

Status Display

Sessions with an associated PR show a status indicator:

Label	Color	Meaning
`PR open`	Green	PR is open
`PR draft`	Muted	PR is a draft
`PR merged`	Primary	PR was merged
`PR closed`	Muted	PR was closed

LazyGit Plugin

The lazygit plugin provides commands to open lazygit in a tmux popup. Auto-detected when lazygit is installed.

plugins:
  lazygit:
    enabled: true # auto-detected (requires `lazygit`)

Commands Provided

Command	Description	Default Key
`LazyGitOpen`	Open lazygit (full popup)	—
`LazyGitCommits`	Open lazygit commit log	—

Neovim Plugin

The neovim plugin provides a command to open neovim in the session's tmux session. Auto-detected when nvim is installed.

plugins:
  neovim:
    enabled: true # auto-detected (requires `nvim`)

Commands Provided

Command	Description	Default Key
`NeovimOpen`	Open neovim in new tmux window	—

Context Directory Plugin

The context directory plugin provides commands to open context directories in the system file browser. Always available on macOS and Linux.

plugins:
  contextdir:
    enabled: true # always available on macOS/Linux

Commands Provided

Command	Description	Default Key
`ContextOpenSession`	Open session's `.hive` directory	—
`ContextOpenAll`	Open all context directories	—