akm-opencode

akm-opencode

OpenCode plugin for the Agentikit CLI. Registers tools that let your AI agent search, show, and manage extension assets from stash directories and registries.

Installation

Add to your OpenCode config (opencode.json):

{
  "plugin": ["akm-opencode"]
}

Tools

Tool	Description
akm_search	Search the local stash, the registry, or both for scripts, skills, commands, agents, and knowledge
akm_registry_search	Search configured registries for installable kits and optional asset-level hits
akm_show	Show a stash asset by its ref
akm_index	Build or rebuild the search index
akm_agent	Dispatch a stash agent:* into OpenCode using the stash prompt and metadata
akm_cmd	Execute a stash command:* template in OpenCode via SDK session prompting
akm_add	Install kits from npm, GitHub, git URLs, or local directories
akm_list	List installed registry kits
akm_remove	Remove an installed registry kit and reindex
akm_update	Update one installed kit or all installed kits
akm_clone	Clone an asset into the working stash or a custom destination for editing
akm_config	Get, set, unset, list, or inspect akm configuration (including config path --all)
akm_run	Execute a stash script using its run field
akm_sources	List all resolved stash search paths
akm_upgrade	Check for or install akm CLI updates

Registry discovery

Use either:

• akm_search with source: "registry" or source: "both"
• akm_registry_search when you only want installable community kits

Registry hits include id, installRef, and action fields. Use installRef when passing a result into akm_add; registry-specific IDs are not installable refs. Use assets: true when you also want asset-level matches from registry v2 indexes.

Agent Dispatch

Use akm_agent after retrieving an agent ref from akm_search.

Inputs:

• ref (optional): stash ref like agent:coach.md
• query (optional): resolve best matching stash agent when ref is omitted
• task_prompt (required): user task to run
• dispatch_agent (optional): OpenCode agent name (defaults to general)
• as_subtask (optional): create child session (defaults to true)

At least one of ref or query is required.

Behavior:

• Loads the stash agent via akm show
• Uses stash prompt verbatim as OpenCode system
• Applies stash modelHint when in provider/model format
• Applies stash toolPolicy when it maps to boolean tool flags

Command Execution

Use akm_cmd to execute stash command templates through the OpenCode SDK.

Inputs:

• ref (optional): stash ref like command:review.md
• query (optional): resolve best matching stash command when ref is omitted
• arguments (optional): raw command arguments for $ARGUMENTS, $1, $2, etc.
• dispatch_agent (optional): OpenCode agent name (defaults to current agent)
• as_subtask (optional): create child session (defaults to false)

At least one of ref or query is required.

Prerequisites

When the plugin loads, it runs bun install -g akm-cli@latest so it always picks up the latest published npm package. It then prefers the Bun-installed binary and falls back to an existing akm on PATH when needed. It does not run the standalone shell installers automatically.

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/itlackey/agentikit/main/install.sh | bash
# PowerShell (Windows)
irm https://raw.githubusercontent.com/itlackey/agentikit/main/install.ps1 -OutFile install.ps1; ./install.ps1

# Or via Bun
bun install -g akm-cli@latest

Stash model

The stash directory is resolved automatically via a three-tier fallback: AKM_STASH_DIR env var (optional override) → stashDir in config.json → platform default. Set it persistently with:

akm config set stashDir /abs/path/to/your-stash

Expected layout:

stash/
├── scripts/    # executable scripts (.sh, .ts, .js, .ps1, .cmd, .bat, .py, .rb, .go, .pl, .php, .lua, .r, .swift, .kt)
├── skills/     # skill directories containing SKILL.md
├── commands/   # markdown files
├── agents/     # markdown files
└── knowledge/  # markdown files

Assets are resolved from three source types: working (local stash), search paths (additional dirs via searchPaths config), and installed (registry kits via akm add).

Docs

• Agentikit CLI
• OpenCode Plugins
• OpenCode Custom Tools