Connected workflows
Environment selection, shared assets, GitHub integration, and machine inspection.
These commands use the connection saved by login and init. Asset origins accept org, team/<slug>, repo/<slug>, dev/<slug>, or me. Scope selections and activation apply machine-wide.
barndog skills remove <name>
Remove skill for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog skills enable <name>
Enable skill for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog skills disable <name>
Disable skill for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog skills fork <name>
Fork an independently owned asset
| Option | Behavior |
|---|---|
--origin <origin> | Source origin Required. |
--target <origin> | Destination origin Required. |
--name <newName> | Destination asset name Required. |
--key <key> | Stable key for exact retries Required. |
barndog skills promote <name>
Propose promotion of an independently owned asset
| Option | Behavior |
|---|---|
--origin <origin> | Source origin Required. |
--target <origin> | Destination origin Required. |
--name <newName> | Destination asset name Required. |
--key <key> | Stable key for exact retries Required. |
barndog skills push [name]
Submit this editable package as a Suggested Change
| Option | Behavior |
|---|---|
--origin <origin> | Origin for a new package Required. |
--publish | Publish with direct authority |
--new | Start a new proposal |
--title <title> | Proposal title Required. |
barndog skills create <name>
Create an editable package without installing it
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
--directory <path> | New editable folder Required. |
barndog mcp list
List accessible MCP configurations
| Option | Behavior |
|---|---|
--search <keywords> | Search names and origins. |
--origin <origin> | Filter by org, team/name, repo/name, or dev/name, or a type alone. |
--page <number> | Results page, starting at 1. |
--limit <number> | Results per page, default 20, maximum 100. |
Search and pagination filter the complete visible catalog locally. Next-page instructions appear when more results exist.
barndog mcp install <name>
Install mcp for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog mcp remove <name>
Remove mcp for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog mcp enable <name>
Enable mcp for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog mcp disable <name>
Disable mcp for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog mcp fork <name>
Fork an independently owned asset
| Option | Behavior |
|---|---|
--origin <origin> | Source origin Required. |
--target <origin> | Destination origin Required. |
--name <newName> | Destination asset name Required. |
--key <key> | Stable key for exact retries Required. |
barndog mcp promote <name>
Propose promotion of an independently owned asset
| Option | Behavior |
|---|---|
--origin <origin> | Source origin Required. |
--target <origin> | Destination origin Required. |
--name <newName> | Destination asset name Required. |
--key <key> | Stable key for exact retries Required. |
barndog mcp create <name>
Create an MCP configuration directly
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
--file <file> | JSON connection definition with secret references Required. |
--key <key> | Stable key for exact retries Required. |
barndog mcp update <name>
Publish a new revision of an MCP configuration directly
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
--file <file> | JSON connection definition with secret references Required. |
--key <key> | Stable key for exact retries Required. |
--expected-version <id> | Inspected configuration version ID Required. |
barndog mcp show <name>
Inspect a connection definition
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
barndog mcp versions <name>
Inspect immutable configuration history
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
barndog mcp auth <name>
Enter native authentication without sharing credentials
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
--harness <harness> | Native login owner Required. |
barndog hooks list
List accessible Hooks
| Option | Behavior |
|---|---|
--search <keywords> | Search names and origins. |
--origin <origin> | Filter by org, team/name, repo/name, or dev/name, or a type alone. |
--page <number> | Results page, starting at 1. |
--limit <number> | Results per page, default 20, maximum 100. |
Search and pagination filter the complete visible catalog locally. Next-page instructions appear when more results exist.
barndog hooks install <name>
Install hook for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog hooks remove <name>
Remove hook for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog hooks enable <name>
Enable hook for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog hooks disable <name>
Disable hook for your selected harnesses
| Option | Behavior |
|---|---|
--origin <origin> | Owning scope, such as team/engineering Required. |
barndog hooks fork <name>
Fork an independently owned asset
| Option | Behavior |
|---|---|
--origin <origin> | Source origin Required. |
--target <origin> | Destination origin Required. |
--name <newName> | Destination asset name Required. |
--key <key> | Stable key for exact retries Required. |
barndog hooks promote <name>
Propose promotion of an independently owned asset
| Option | Behavior |
|---|---|
--origin <origin> | Source origin Required. |
--target <origin> | Destination origin Required. |
--name <newName> | Destination asset name Required. |
--key <key> | Stable key for exact retries Required. |
barndog hooks test <name>
Explicitly run one published command Hook with test input
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
--harness <harness> | Chosen implementation Required. |
--input <file> | Native JSON test input Required. |
--event <event> | Native event name Required. |
--handler <number> | One-based command index Required. |
--timeout <seconds> | Maximum test duration Required. |
barndog hooks compatibility <name>
Inspect version-specific declarations and local runtime requirements
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
barndog hooks pull <name>
Pull a Hook into an editable folder
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin, such as team/engineering Required. |
--directory <path> | Editable working folder Required. |
barndog hooks versions <name>
List published history
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
barndog hooks show <name>
Read a published version's files
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
--version <number> | Published version Required. |
barndog hooks diff <name>
Compare published versions
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
--from <number> | Old version Required. |
--to <number> | New version Required. |
barndog hooks push [name]
Submit this editable package as a Suggested Change
| Option | Behavior |
|---|---|
--origin <origin> | Origin for a new package Required. |
--publish | Publish with direct authority |
--new | Start a new proposal |
--title <title> | Proposal title Required. |
barndog hooks create <name>
Create an editable package without installing it
| Option | Behavior |
|---|---|
--origin <origin> | Owning origin Required. |
--directory <path> | New editable folder Required. |
barndog hooks changes list
List accessible Suggested Changes
barndog hooks changes show <id>
Read proposal content, reviews, and discussion history
barndog hooks changes diff <id>
Inspect a proposal diff
| Option | Behavior |
|---|---|
--revision <number> | Proposal revision Required. |
--from-revision <number> | Compare to another proposal revision Required. |
barndog hooks changes approve <id>
Approve a reviewed revision
| Option | Behavior |
|---|---|
--revision <number> | Revision you reviewed Required. |
barndog hooks changes request-changes <id>
Request further changes
| Option | Behavior |
|---|---|
--revision <number> | Revision you reviewed Required. |
barndog hooks changes reject <id>
Close a proposal as its author or admin
| Option | Behavior |
|---|---|
--revision <number> | Revision you reviewed Required. |
barndog hooks changes merge <id>
Publish a proposal under its scope's merge rules
| Option | Behavior |
|---|---|
--revision <number> | Revision you reviewed Required. |
barndog hooks changes comment <id>
Comment, reply, or suggest an inline replacement
| Option | Behavior |
|---|---|
--revision <number> | Proposal revision Required. |
--body <text> | Comment text Required. |
--body-file <path> | Read comment text from a file Required. |
--thread <id> | Reply to a discussion Required. |
--path <path> | Package file for an inline discussion Required. |
--side <side> | old or new Required. |
--start-line <number> | First line Required. |
--end-line <number> | Last line Required. |
--replacement-file <path> | Replacement text file Required. |
--expected-file <path> | Exact original text file Required. |
barndog hooks changes apply <id> <thread>
Apply a current reviewer suggestion
| Option | Behavior |
|---|---|
--revision <number> | Current proposal revision Required. |
barndog hooks changes resolve-discussion <id> <thread>
Resolve a discussion
| Option | Behavior |
|---|---|
--revision <number> | Current proposal revision Required. |
barndog hooks changes reopen-discussion <id> <thread>
Reopen a discussion
| Option | Behavior |
|---|---|
--revision <number> | Current proposal revision Required. |
barndog sets list
Show subscriptions and accessible scopes
Scope subscriptions follow matching publications and additions/removals on sync. Team switching replaces only team subscriptions. Individual selections, exclusions, and activation overrides remain independent.
| Option | Behavior |
|---|---|
--search <keywords> | Search names and origins. |
--origin <origin> | Filter by org, team/name, repo/name, or dev/name, or a type alone. |
--page <number> | Results page, starting at 1. |
--limit <number> | Results per page, default 20, maximum 100. |
Search and pagination filter the complete visible catalog locally. Next-page instructions appear when more results exist.
barndog sets install
Install a scope subscription
| Option | Behavior |
|---|---|
--origin <origin> | Organization, team or repository scope Required. |
--mode <mode> | Distribution mode. Omit to choose interactively; required without an interactive terminal. |
--overrides <choice> | Resolve matching local overrides Required. |
--decisions <file> | JSON per-asset override choices Required. |
Scope subscriptions follow matching publications and additions/removals on sync. Team switching replaces only team subscriptions. Individual selections, exclusions, and activation overrides remain independent.
Without --mode, choose all assets, recommended only, or custom assets from this source. Custom choices become individual selections and replace this scope subscription if it exists. Selecting no custom assets leaves the environment unchanged. Explicit --mode accepts all, recommended, or optional.
barndog sets remove
Remove a scope subscription
| Option | Behavior |
|---|---|
--origin <origin> | Organization, team or repository scope Required. |
Scope subscriptions follow matching publications and additions/removals on sync. Team switching replaces only team subscriptions. Individual selections, exclusions, and activation overrides remain independent.
barndog sets enable
Enable a scope subscription
| Option | Behavior |
|---|---|
--origin <origin> | Organization, team or repository scope Required. |
Scope subscriptions follow matching publications and additions/removals on sync. Team switching replaces only team subscriptions. Individual selections, exclusions, and activation overrides remain independent.
barndog sets disable
Disable a scope subscription
| Option | Behavior |
|---|---|
--origin <origin> | Organization, team or repository scope Required. |
Scope subscriptions follow matching publications and additions/removals on sync. Team switching replaces only team subscriptions. Individual selections, exclusions, and activation overrides remain independent.
barndog sets switch-team <team>
Replace team subscriptions while preserving individual selections
| Option | Behavior |
|---|---|
--mode <mode> | Selected distribution mode Required. Default: recommended. |
--overrides <choice> | Resolve matching local overrides Required. |
--decisions <file> | JSON per-asset override choices Required. |
Scope subscriptions follow matching publications and additions/removals on sync. Team switching replaces only team subscriptions. Individual selections, exclusions, and activation overrides remain independent.
barndog whoami
Show authenticated identity and organization
barndog open
Open your BarnDog workspace in a browser
barndog compatibility
Inspect selected assets across configured harnesses
Hook compatibility is author-declared. Runtime checks report unmet requirements; this command does not execute Hooks or establish native execution.
barndog repo status
Show the mapped repository, owning team and applicable policy scopes
barndog doctor
Preflight catalog, cached content, ownership and native destinations
barndog environment
Show effective machine-wide selections and their sources
barndog knowledge list
Run knowledge list.
| Option | Behavior |
|---|---|
--always | Only automatic index entries |
barndog knowledge enable
Install the owned lightweight startup index integration
barndog knowledge disable
Remove the owned lightweight startup index integration
barndog knowledge get <name>
Run knowledge get.
barndog people list
Run people list.
| Option | Behavior |
|---|---|
--search <query> | Search developer names or handles Required. |
barndog people show <name>
Run people show.
| Option | Behavior |
|---|---|
--search <query> | Filter visible asset names Required. |
barndog github auth
Run github auth.
| Option | Behavior |
|---|---|
--no-browser | Print the URL without opening it |
barndog github install
Run github install.
| Option | Behavior |
|---|---|
--no-browser | Print the URL without opening it |
barndog github status
Run github status.
barndog github installations
Run github installations.
barndog github list
Run github list.
barndog github connect <name>
Run github connect.
| Option | Behavior |
|---|---|
--kind <kind> | Git-backed asset kind Required. Default: skill. |
--origin <origin> | Owning origin Required. |
--installation <id> | BarnDog installation binding UUID Required. |
--repository <owner/name> | Customer-selected GitHub repository Required. |
--mode <mode> | mirror keeps BarnDog authoritative Required. Default: connect. |
--expected-version <id> | Inspected BarnDog version ID Required. |
barndog github import <name>
Run github import.
| Option | Behavior |
|---|---|
--kind <kind> | Git-backed asset kind Required. Default: skill. |
--origin <origin> | Owning origin Required. |
--installation <id> | BarnDog installation binding UUID Required. |
--repository <owner/name> | Customer-selected GitHub repository Required. |
Use --authority barndog --key <stable-key> to copy published main and its ancestry into independent BarnDog ownership. GitHub remains unchanged and is not connected for future updates. Keep the key for an exact retry. --authority github is the compatibility default and keeps GitHub authoritative.
barndog github show <id>
Run github show.
barndog github sync <id>
Run github sync.
barndog github remote-head <id>
Run github remote-head.
barndog github resolve-mirror <id>
Run github resolve-mirror.
| Option | Behavior |
|---|---|
--action <action> | Explicit divergence resolution Required. |
--expected-version <id> | Inspected BarnDog version Required. |
--expected-remote <sha|absent> | Inspected remote main SHA or absent Required. |
--key <key> | Stable key for exact retries Required. |
Inspect barndog github remote-head <id> before resolving divergence. Pass its commit as --expected-remote (or absent when no main branch exists). A changed remote head stops the write.
barndog github pulls list <id>
Run github pulls list.
barndog github pulls show <id> <number>
Run github pulls show.
barndog github pulls create <id>
Run github pulls create.
| Option | Behavior |
|---|---|
--expected-commit <sha> | Inspected canonical commit Required. |
--title <title> | Pull request title Required. |
--directory <path> | Complete editable package directory Required. |
--body <text> | Pull request body Required. |
--body-file <path> | Pull request body file Required. |
--key <key> | Stable key for exact retries Required. |
barndog github pulls revise <id> <number>
Run github pulls revise.
| Option | Behavior |
|---|---|
--expected-commit <sha> | Inspected pull head commit Required. |
--title <title> | Updated title Required. |
--directory <path> | Complete package directory Required. |
--body <text> | Updated body Required. |
--body-file <file> | Updated body file Required. |
--key <key> | Stable key for exact retries Required. |
barndog github pulls review <id> <number>
Run github pulls review.
| Option | Behavior |
|---|---|
--expected-commit <sha> | Inspected pull head commit Required. |
--body <text> | Review or comment Required. |
--body-file <file> | Review or comment file Required. |
--event <event> | Review decision Required. |
barndog github pulls comment <id> <number>
Run github pulls comment.
| Option | Behavior |
|---|---|
--expected-commit <sha> | Inspected pull head commit Required. |
--body <text> | Review or comment Required. |
--body-file <file> | Review or comment file Required. |
--path <file> | Inline file Required. |
--line <number> | Inline line Required. |
--side <side> | Inline diff side Required. |
barndog github pulls merge <id> <number>
Run github pulls merge.
| Option | Behavior |
|---|---|
--expected-commit <sha> | Inspected pull head commit Required. |
barndog github create-repository <name>
Create an empty GitHub repository and export only this asset's published history.
| Option | Behavior |
|---|---|
--kind skill|hook | Asset kind; defaults to skill. |
--origin <origin> | Required source scope. |
--installation <id> | Required bound App installation for the destination account. |
--repository <owner/name> | Required new destination; existing repositories are rejected. |
--expected-version <id> | Required inspected asset version. |
--mode mirror|transfer | Mirror keeps BarnDog authoritative (default); transfer makes GitHub authoritative. |
--visibility private|public | Explicit visibility; defaults to private. |
--key <key> | Required stable retry key. Reuse with exactly the same options. |
The linked GitHub user needs repository-creation permission and the App needs Administration write permission. For selected-repository installations, add the created repository to the App on GitHub and retry the same command. If GitHub loses the creation response, inspect the repository and connect it explicitly with barndog github connect; BarnDog never silently adopts an existing destination or deletes it on failure.