briar

briar

briar は、ご自身のマシンで動作するコマンドラインツールです。次の2つの機能があります。

1. チームのツール（GitHub、Bitbucket、Jira、Linear、AWS、Fireflies）の状況を読み取り、Markdown の「ナレッジ」として保存します。
2. そのナレッジを使う AI コーディングエージェントを実行します。一方のエージェントはチケットを受け取り、ドラフト PR を開きます。もう一方は PR のレビューコメントを修正します。

briar サーバーもアカウントもありません。briar が通信するのは、設定したサービス（コードホスト、トラッカー、クラウド、LLM プロバイダー）のみです。認証情報はマシン上のファイルに保存されます。

インストール

pip install briar-cli
briar version

briar-cli 1.1.75（またはそれ以降）がインストールされます。briar には Python 3.10 以降が必要です。

基本インストールには、GitHub、Bitbucket、AWS、Jira、Linear、Fireflies、Anthropic（Claude）、AWS Bedrock と、ファイルまたは Postgres のストアが含まれます。コーディングエージェントも実行できます。追加機能は次のとおりです。

pip install 'briar-cli[mcp]'      # briar mcp serve, briar chat, MCP tools for agents
pip install 'briar-cli[all]'      # everything below

追加機能は [openai]、[gemini]、[mcp]、[gcp]、[azure]、[vault] です。

briar agent または briar plan run を実行するには、エージェントが使用する git と GitHub CLI gh も必要です。

[mcp] の追加機能では、次の3つが追加されます。

• briar mcp serve と briar chat。この追加機能なしでは起動しません。
• ランブックの mcp: に記載されたツールサーバー。このようなランブックでエージェントを実行すると、追加機能がない場合は停止します。
• エージェント向けの小さなヘルパーツール「think」と「time」。追加機能がない場合、briar はこれらをスキップし、警告を1つ記録して続行します。

1.1.74 以降は、通常のインストールでエージェントを実行できます。それ以前のバージョンでは、--no-default-mcp を指定しない限り、MCP support requires the `mcp` package で停止していました。

クイックスタート

# 1. Save a GitHub token and Jira login. They go to ~/.config/briar/secrets.env
briar auth login github-pat --company acme
briar auth login jira-token --company acme

# 2. Give briar a Claude key. It reads it from your shell.
export ANTHROPIC_API_KEY=sk-ant-your-key

# 3. Read the repo's recent PRs and its tools into the blob knowledge:acme
briar extract --company acme --repo acme-co/acme-app \
    --include pr-archaeology --include codebase-conventions --max 50

# 4. Read what was saved
briar context get knowledge:acme

# 5. Print the agent's prompt for ticket ACME-42. No cost, nothing pushed.
briar agent implement --company acme --repo acme-co/acme-app \
    --ticket-key ACME-42 --tracker jira --dry-run

# 6. Run it for real: clone, branch, code, test, open a draft PR
briar agent implement --company acme --repo acme-co/acme-app \
    --ticket-key ACME-42 --tracker jira

手順3の後、./knowledge/knowledge/acme.md が作成されます。手順6の後、ブランチ chore/acme-42 と、acme-co/acme-app のドラフト PR が作成されます。

.briar.toml で入力を減らす

各設定は、入力したフラグ、環境変数、.briar.toml、組み込みのデフォルト値の順に参照されます。リポジトリのオーナーと名前は、git の origin リモートから取得することもできます。

リポジトリにひな形ファイルを書き込みます。

briar init --company acme

git から取得した会社、ストア、リポジトリが設定された .briar.toml が作成されます。[agent] の部分はコメントアウトされています。コメントを解除すると、エージェントのデフォルト値を設定できます。

company = "acme"
store   = "file"

[repo]
owner    = "acme-co"
repo     = "acme-app"
provider = "github"

[agent]
model          = "claude-sonnet-4-6"
git_user_name  = "Acme Bot"
git_user_email = "[email protected]"

そのリポジトリ内では、コマンドを短くできます。

briar extract --include pr-archaeology
briar agent implement --ticket-key ACME-42

briar config show は、各設定とその取得元を表示します。 briar doctor は、設定、git、認証情報、ストアを確認します。 eval "$(briar completion bash)" を実行すると、タブ補完が有効になります（zsh でも動作します）。 setup.md を参照してください。

Docker で実行する

iklob1/briar イメージには、briar、[mcp] の追加機能、git、gh が含まれています。 ほかにインストールするものはありません。

docker run --rm iklob1/briar version

リポジトリで作業するには、リポジトリと briar の設定フォルダーをマウントします。

docker run --rm \
    -v "$PWD":/work -w /work \
    -v "$HOME/.config/briar":/home/briar/.config/briar \
    -e ANTHROPIC_API_KEY \
    iklob1/briar extract --company acme --include pr-archaeology

• -v "$PWD":/work -w /work はリポジトリをマウントするため、.briar.toml と ./knowledge はマシン上と同じように使えます。
• -v "$HOME/.config/briar":/home/briar/.config/briar は、briar auth login で保存した認証情報をマウントします。
• -e ANTHROPIC_API_KEY はシェルの環境変数を渡します。他の環境変数も渡すには、-e を繰り返し指定します。保存済みの認証情報には -e は不要です。

一部のコマンドには、追加の指定が必要です。

コマンド	追加するもの
auth login	トークンを貼り付ける必要があるため、-it を指定します。
dashboard	-p 8080:8080 と、最後に --host 0.0.0.0 を指定します。
mcp serve over stdio	MCP クライアントが通信できるように、-i を指定します。

docker run --rm -it -v "$HOME/.config/briar":/home/briar/.config/briar \
    iklob1/briar auth login github-pat --company acme

docker run --rm -p 8080:8080 -v "$PWD":/work -w /work \
    iklob1/briar dashboard --host 0.0.0.0

Docker でエージェントを実行する

1.1.75 以降では、イメージで briar agent と briar plan run を実行できます。2 つのキーと Git の名前およびメールアドレスを追加します。

docker run --rm \
    -v "$PWD":/work -w /work \
    -v "$HOME/.config/briar":/home/briar/.config/briar \
    -e GITHUB_TOKEN -e ANTHROPIC_API_KEY \
    iklob1/briar agent implement --company acme --repo acme-co/acme-app \
    --ticket-key ACME-42 --tracker jira \
    --git-user-name "Dana Lee" --git-user-email [email protected]

お使いのマシンと同じ手順が実行されます。ブランチ chore/acme-42 が作成され、acme-co/acme-app にドラフト PR が作成されます。最初にプロンプトを確認するには、--dry-run を追加します。

• --git-user-name と --git-user-email を指定すると、コミットにお使いの名前とメールアドレスが設定されます。代わりに ~/.gitconfig を読み取り専用でマウントすることもできます。 -v "$HOME/.gitconfig":/home/briar/.gitconfig:ro。
• -e GITHUB_TOKEN を指定すると、git push と gh が GitHub にログインできます。イメージ内では、git が gh にログイン情報を問い合わせ、gh が GITHUB_TOKEN を読み取ります。
• -e ANTHROPIC_API_KEY は Claude のキーです。-e CLAUDE_CODE_OAUTH_TOKEN も使用できます。
• Jira のキーは、マウントされた設定フォルダーから読み込まれます。
• マウントされた .briar.toml の [repo] からも --repo を指定できます。

知っておくと便利なこと：

• Mac の ~/.gitconfig も使用できます。gh auth setup-git を実行すると、お使いのマシン上の gh のパス（/usr/local/bin/gh または /opt/homebrew/bin/gh）が書き込まれます。1.1.79 以降、イメージには両方のパスに gh があります。それ以前は、「gh: not found」というエラーで push に失敗していました。
• briar は、マウントされたリポジトリの git の origin リモートから、オーナーとリポジトリを読み込むこともできます。1.1.79 以降は、フォルダーの所有者にかかわらず動作します。それ以前は Linux で、git が uid 1000 の所有ではないフォルダーを拒否していたため（「detected dubious ownership」）、--repo を渡す必要がありました。
• イメージで設定される git のログイン先は GitHub のみです。Bitbucket の場合は、ローカルインストールからエージェントを実行してください。
• イメージでは BRIAR_NO_DEFAULT_MCP=1 が設定されています。エージェントのヘルパーツール用の npx または uvx が含まれていないためです。これらを追加した独自のイメージでは、-e BRIAR_NO_DEFAULT_MCP=0 を渡せます。
• イメージは linux/amd64 専用にビルドされています。Apple Silicon では、Docker がエミュレーションを使って実行します。
• コンテナーはユーザー briar（uid 1000）として実行されます。Linux では、マウントするフォルダーにこの uid で書き込みできる必要があります。
• タグは latest と各バージョンです。例：iklob1/briar:1.1.75。

コマンド

各コマンドのマニュアルはagents/にあります。 より多くの例を含む同じリファレンスは、 usebriar.com/docsにあります。

コマンド	機能	マニュアル
briar extract	ツールを読み込み、ナレッジの塊にまとめます（抽出機能は23種類）。	extract.md
briar agent implement	チケットを1件受け取り、ドラフトPRを作成します。	agent.md
briar agent prfix	PRを1件選び、レビューコメントを修正して返信します。	agent.md
briar plan	JiraまたはGitHub Projectsのボードを計画に変換し、カードごとに実行します。	plan.md
briar runbook	YAMLファイルから抽出機能を一度またはスケジュールに従って実行します。	runbook.md
briar context	ナレッジの塊を読み込み、書き込み、一覧表示、削除します。	context.md
briar scaffold	エージェントのワークフロー用のJSON設定バンドルを作成します。	scaffold.md
briar auth	認証情報を保存します（login、logout、list、status、refresh）。	auth.md
briar secrets	不足している認証情報を表示します（doctor、bootstrap）。	creds.md
briar journal	plan runとscaffoldで記録された決定事項を表示します。	journal.md
briar dashboard	読み取り専用のステータスページを提供します。	dashboard.md
briar mcp serve、briar chat	briarをMCPツールとして提供するか、ターミナルのチャットから操作します。	mcp.md
briar init、config show、doctor、completion	セットアップ用の補助コマンドです。	setup.md
briar telemetry	送信する使用状況データを表示または変更します。	telemetry.md
briar version	バージョンを出力します。	version.md

これらのコマンドを連結したレシピは flows.mdにあります。すべての機能を使う runbookは examples/all_features.yamlです。

次の3つのフラグは、コマンドのどこに指定しても使用できます。

フラグ	機能
--format table|json|yaml|csv|quiet	出力形式です。一覧のデフォルトはtable、単一レコードのデフォルトはjsonです。
--verbose、-v	stderrにデバッグログを出力します。BRIAR_VERBOSE=1でも同じです。
--version、-V	バージョンを出力して終了します。

テレメトリー

briarはデフォルトでエラーレポートと使用回数を送信します。プロンプト、ファイルの内容、チケットキー、リポジトリ名、パス、シークレットの値がマシンの外に送信されることはありません。briar telemetry off、BRIAR_TELEMETRY=off、 またはDO_NOT_TRACK=1で無効にできます。

ライセンス

MIT。LICENSEを参照してください。