TBH CLI

Install once, then use the tbh command directly:

bun add --global @graphyn/tbh

tbh search postgres
tbh search editor --type mode agent
tbh list
tbh list --type mode
tbh install graphyn/[email protected]
tbh update graphyn/example
tbh update all
tbh login
tbh owner show
tbh owner set graphyn
tbh init skill my-skill
tbh init mode my-mode
tbh init agent my-agent
tbh init source my-source
tbh validate ./my-skill
tbh publish ./my-skill
tbh delete graphyn/example
tbh logout
tbh rate graphyn/example 8
tbh ranking
tbh ranking monthly
tbh ranking yearly
tbh ranking review
tbh ranking monthly review
tbh ranking yearly review
tbh ranking monthly --type mode
tbh link codex
tbh link graphyn

For one-off usage without a global install:

bunx @graphyn/tbh search postgres
bunx @graphyn/tbh install graphyn/[email protected]

Packages live once under ~/.tbh/{skills,modes,agents,sources}/{owner}/{slug}/{version}. The registry response identifies the package type, so tbh install does not need a separate type argument. The current symlink selects the active version. tbh link codex and tbh link claude create one agent-visible symlink per installed skill. tbh link graphyn links all four canonical catalogs at ~/.graphyn/{skills,modes,agents,sources}/tbh; it does not copy packages. Once linked, installs, updates and removals remain visible to every linked adapter.

First-time tbh login completes owner namespace setup in the browser before returning to the CLI. The owner can also be created or changed later with tbh owner set <slug>.

Create and validate packages

Create a safe starter package in a new <slug> directory:

tbh init skill security-review
tbh init mode concise
tbh init agent code-reviewer
tbh init source design-system

Use --directory . to initialize the current directory. tbh init never overwrites an existing SKILL.md, MODE.md, SOURCE.md, agent.yaml, or AGENT.md. If a target manifest already exists, it exits before changing any files.

Validate an existing package without modifying or uploading it:

tbh validate .

Skills require a root SKILL.md, modes require a root MODE.md, and sources require a root SOURCE.md. All three use YAML frontmatter followed by non-empty Markdown instructions:

---
name: security-review
description: Reviews source code for security vulnerabilities.
---

# Security Review

Review the requested code and report actionable security findings.

Agents require both agent.yaml and a non-empty AGENT.md:

schema: tbh.md/agent/v1alpha1
name: code-reviewer
description: Reviews repositories for correctness and security risks.
prompt: AGENT.md
dependencies:
  sources:
    standards:
      ref: graphyn/design-system
      version: ^1.0.0
      required: true

tbh publish runs the same validation automatically before uploading anything. tbh delete owner/slug removes a package and all of its published versions from the registry after an interactive y/n confirmation. This is different from tbh remove owner/slug, which only removes the locally installed copy.

Rankings use downloads by default and cover the last week unless monthly or yearly is supplied. Add review to rank by average rating; review rankings only include packages with at least 100 ratings in the selected period. Use --type skill, --type mode, --type agent, or --type source to select one ranking.