BarnDog

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

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog skills enable <name>

Enable skill for your selected harnesses

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog skills disable <name>

Disable skill for your selected harnesses

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog skills fork <name>

Fork an independently owned asset

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--origin <origin>Origin for a new package Required.
--publishPublish with direct authority
--newStart a new proposal
--title <title>Proposal title Required.

barndog skills create <name>

Create an editable package without installing it

OptionBehavior
--origin <origin>Owning origin Required.
--directory <path>New editable folder Required.

barndog mcp list

List accessible MCP configurations

OptionBehavior
--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

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog mcp remove <name>

Remove mcp for your selected harnesses

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog mcp enable <name>

Enable mcp for your selected harnesses

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog mcp disable <name>

Disable mcp for your selected harnesses

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog mcp fork <name>

Fork an independently owned asset

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--origin <origin>Owning origin Required.

barndog mcp versions <name>

Inspect immutable configuration history

OptionBehavior
--origin <origin>Owning origin Required.

barndog mcp auth <name>

Enter native authentication without sharing credentials

OptionBehavior
--origin <origin>Owning origin Required.
--harness <harness>Native login owner Required.

barndog hooks list

List accessible Hooks

OptionBehavior
--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

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog hooks remove <name>

Remove hook for your selected harnesses

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog hooks enable <name>

Enable hook for your selected harnesses

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog hooks disable <name>

Disable hook for your selected harnesses

OptionBehavior
--origin <origin>Owning scope, such as team/engineering Required.

barndog hooks fork <name>

Fork an independently owned asset

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--origin <origin>Owning origin Required.

barndog hooks pull <name>

Pull a Hook into an editable folder

OptionBehavior
--origin <origin>Owning origin, such as team/engineering Required.
--directory <path>Editable working folder Required.

barndog hooks versions <name>

List published history

OptionBehavior
--origin <origin>Owning origin Required.

barndog hooks show <name>

Read a published version's files

OptionBehavior
--origin <origin>Owning origin Required.
--version <number>Published version Required.

barndog hooks diff <name>

Compare published versions

OptionBehavior
--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

OptionBehavior
--origin <origin>Origin for a new package Required.
--publishPublish with direct authority
--newStart a new proposal
--title <title>Proposal title Required.

barndog hooks create <name>

Create an editable package without installing it

OptionBehavior
--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

OptionBehavior
--revision <number>Proposal revision Required.
--from-revision <number>Compare to another proposal revision Required.

barndog hooks changes approve <id>

Approve a reviewed revision

OptionBehavior
--revision <number>Revision you reviewed Required.

barndog hooks changes request-changes <id>

Request further changes

OptionBehavior
--revision <number>Revision you reviewed Required.

barndog hooks changes reject <id>

Close a proposal as its author or admin

OptionBehavior
--revision <number>Revision you reviewed Required.

barndog hooks changes merge <id>

Publish a proposal under its scope's merge rules

OptionBehavior
--revision <number>Revision you reviewed Required.

barndog hooks changes comment <id>

Comment, reply, or suggest an inline replacement

OptionBehavior
--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

OptionBehavior
--revision <number>Current proposal revision Required.

barndog hooks changes resolve-discussion <id> <thread>

Resolve a discussion

OptionBehavior
--revision <number>Current proposal revision Required.

barndog hooks changes reopen-discussion <id> <thread>

Reopen a discussion

OptionBehavior
--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.

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--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

OptionBehavior
--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.

OptionBehavior
--alwaysOnly 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.

OptionBehavior
--search <query>Search developer names or handles Required.

barndog people show <name>

Run people show.

OptionBehavior
--search <query>Filter visible asset names Required.

barndog github auth

Run github auth.

OptionBehavior
--no-browserPrint the URL without opening it

barndog github install

Run github install.

OptionBehavior
--no-browserPrint 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.

OptionBehavior
--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.

OptionBehavior
--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.

OptionBehavior
--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.

OptionBehavior
--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.

OptionBehavior
--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.

OptionBehavior
--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.

OptionBehavior
--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.

OptionBehavior
--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.

OptionBehavior
--kind skill|hookAsset 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|transferMirror keeps BarnDog authoritative (default); transfer makes GitHub authoritative.
--visibility private|publicExplicit 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.

On this page

barndog skills remove <name>barndog skills enable <name>barndog skills disable <name>barndog skills fork <name>barndog skills promote <name>barndog skills push [name]barndog skills create <name>barndog mcp listbarndog mcp install <name>barndog mcp remove <name>barndog mcp enable <name>barndog mcp disable <name>barndog mcp fork <name>barndog mcp promote <name>barndog mcp create <name>barndog mcp update <name>barndog mcp show <name>barndog mcp versions <name>barndog mcp auth <name>barndog hooks listbarndog hooks install <name>barndog hooks remove <name>barndog hooks enable <name>barndog hooks disable <name>barndog hooks fork <name>barndog hooks promote <name>barndog hooks test <name>barndog hooks compatibility <name>barndog hooks pull <name>barndog hooks versions <name>barndog hooks show <name>barndog hooks diff <name>barndog hooks push [name]barndog hooks create <name>barndog hooks changes listbarndog hooks changes show <id>barndog hooks changes diff <id>barndog hooks changes approve <id>barndog hooks changes request-changes <id>barndog hooks changes reject <id>barndog hooks changes merge <id>barndog hooks changes comment <id>barndog hooks changes apply <id> <thread>barndog hooks changes resolve-discussion <id> <thread>barndog hooks changes reopen-discussion <id> <thread>barndog sets listbarndog sets installbarndog sets removebarndog sets enablebarndog sets disablebarndog sets switch-team <team>barndog whoamibarndog openbarndog compatibilitybarndog repo statusbarndog doctorbarndog environmentbarndog knowledge listbarndog knowledge enablebarndog knowledge disablebarndog knowledge get <name>barndog people listbarndog people show <name>barndog github authbarndog github installbarndog github statusbarndog github installationsbarndog github listbarndog github connect <name>barndog github import <name>barndog github show <id>barndog github sync <id>barndog github remote-head <id>barndog github resolve-mirror <id>barndog github pulls list <id>barndog github pulls show <id> <number>barndog github pulls create <id>barndog github pulls revise <id> <number>barndog github pulls review <id> <number>barndog github pulls comment <id> <number>barndog github pulls merge <id> <number>barndog github create-repository <name>