Sable Platform + HyperDX Observability

Anvil

Sable の AI 音声エージェントプラットフォーム向けのコマンドラインインターフェースおよび MCP サーバーです。

クイックスタート（2 分）

# 1. Install
go install github.com/sable-inc/anvil/cmd/anvil@latest

# 2. Authenticate
anvil auth login --token svc_your_token_here

# 3. Set your default org
mkdir -p ~/.config/anvil
cat > ~/.config/anvil/config.yaml << 'EOF'
default_org: "your-org"
api_url: "https://api.withsable.com"
EOF

# 4. Set up shell completions (zsh)
echo 'source <(anvil completion zsh)' >> ~/.zshrc
source ~/.zshrc

# 5. Verify
anvil auth status
anvil agent list

インストール

オプション 1：Homebrew（推奨）

brew install sable-inc/tap/anvil

オプション 2：Go でインストール

go install github.com/sable-inc/anvil/cmd/anvil@latest

これにより、anvil バイナリが $GOPATH/bin（通常は ~/go/bin）に配置されます。このディレクトリが $PATH に含まれていることを確認してください。

# Add to your shell profile if not already there
export PATH="$HOME/go/bin:$PATH"

オプション 3：バイナリをダウンロード（Go 不要）

GitHub Releases から最新のリリースをダウンロードします。

macOS（Apple Silicon）：

curl -sL https://github.com/sable-inc/anvil/releases/latest/download/anvil_darwin_arm64.tar.gz | tar xz
sudo mv anvil /usr/local/bin/

macOS（Intel）：

curl -sL https://github.com/sable-inc/anvil/releases/latest/download/anvil_darwin_amd64.tar.gz | tar xz
sudo mv anvil /usr/local/bin/

Linux（amd64）：

curl -sL https://github.com/sable-inc/anvil/releases/latest/download/anvil_linux_amd64.tar.gz | tar xz
sudo mv anvil /usr/local/bin/

または、リリースページから手動でダウンロードします。

オプション 4：ソースからビルド

git clone https://github.com/sable-inc/anvil.git
cd anvil
make build
sudo mv bin/anvil /usr/local/bin/

インストールの確認

anvil version
# anvil v0.1.0 (commit: abc1234, built: 2026-02-14T..., darwin/arm64)

認証

Anvil はサービス トークンを使用して sable-api に対して認証します。

# Store your token (one-time)
anvil auth login --token svc_your_token_here

# Verify it works
anvil auth whoami    # shows stored token info
anvil auth status    # verifies API connectivity

認証情報は ~/.config/anvil/credentials.json に保存されます（ファイル権限：0600）。

サービス トークンを取得するには、チーム管理者に依頼するか、Sable Platform ダッシュボードで生成してください。

設定

~/.config/anvil/config.yaml を作成します。

default_org: "my-org"
api_url: "https://api.withsable.com"
format: "table"

フラグを使って任意の設定を上書きできます。

anvil --org other-org --format json agent list

設定	フラグ	設定キー	説明
組織	--org	default_org	すべてのコマンドのデフォルト組織
API URL	--api-url	api_url	Sable API のベース URL
出力形式	--format	format	table、json、または yaml
色なし	--no-color	—	色付き出力を無効にする
詳細表示	--verbose	—	デバッグログを有効にする

シェル補完

Anvil には、稼働中の API から実際のリソース名を候補として提示する、動的なタブ補完機能があります。

セットアップ（初回のみ・永続的）

Zsh（macOS のデフォルト）：

echo 'source <(anvil completion zsh)' >> ~/.zshrc
source ~/.zshrc

Bash：

echo 'source <(anvil completion bash)' >> ~/.bashrc
source ~/.bashrc

Fish：

anvil completion fish > ~/.config/fish/completions/anvil.fish

PowerShell：

anvil completion powershell >> $PROFILE

利用できる機能

セットアップ後は、どこでも TAB を押せます。

anvil <TAB>                      # all subcommands
anvil agent get <TAB>            # suggests agent slugs + IDs from API
anvil journey delete <TAB>       # suggests journey slugs + IDs
anvil kb sync <TAB>              # suggests KB item IDs with names
anvil config pull <TAB>          # suggests config version IDs
anvil connect <TAB>              # suggests agent slugs
anvil --format <TAB>             # suggests table, json, yaml

補完候補は、保存済みのトークンを使って API から最新データを取得します。認証されていない場合は、エラーを表示せず、候補を表示しません。

FAQ

anvil またはシェルを更新するたびに補完を再生成する必要がありますか？ いいえ。source <(anvil completion ...) のパターンでは、新しいシェルセッションを開始するたびに自動的に再生成されます。Fish の場合、新しいコマンドが追加されていれば、anvil の更新後にファイルを書き込むコマンドを再実行してください。

コマンド

エージェント

anvil agent list                     # List agents
anvil agent get <id|slug>            # Get agent details
anvil agent create --name "My Agent" # Create agent
anvil agent update <id> --name "New" # Update agent
anvil agent delete <id>              # Delete agent

ジャーニー

anvil journey list                   # List journeys
anvil journey get <id>               # Get journey with moments/transitions
anvil journey create --name "Flow"   # Create journey

ナレッジベース

anvil kb list                        # List knowledge base items
anvil kb get <id>                    # Get item details
anvil kb search "query"              # Semantic search
anvil kb import-url <url>            # Import a URL
anvil kb import-sitemap <url> --name "Docs"  # Import from sitemap
anvil kb sync <id>                   # Sync item to vector store
anvil kb sync-all                    # Sync all items
anvil kb crawl <id>                  # Re-crawl a URL item
anvil kb delete <id>                 # Delete item
anvil kb job <jobId>                 # Check sitemap import job status

Config-as-Code

anvil config list                    # List config versions
anvil config get <id>                # Get config version details
anvil config pull <id> -o config.yaml  # Download config as YAML
anvil config push config.yaml        # Upload config from YAML
anvil config validate config.yaml    # Validate config locally
anvil config diff config.yaml --id <id>  # Diff local vs remote

分析とトランスクリプト

anvil analytics sessions             # Session analytics
anvil analytics stages               # Stage funnel analytics
anvil transcript list                # List transcripts
anvil transcript view <id>           # View transcript messages

デプロイ

anvil deploy history --org org_xxx            # List deployment history
anvil deploy trigger --org org_xxx            # Trigger a deployment
anvil deploy trigger --org org_xxx --watch    # Trigger and poll until complete
anvil deploy rollback --org org_xxx           # Rollback deployment
anvil deploy create --org org_xxx             # Create initial deployment
anvil deploy delete --org org_xxx             # Delete deployment
anvil deploy update-secrets --org org_xxx     # Update deployment secrets
anvil deploy pin-forge --org org_xxx --forge-version v1.0  # Pin forge version

LiveKit

# Sessions
anvil livekit sessions list --org org_xxx     # List active rooms
anvil livekit sessions get <room> --org org_xxx
anvil livekit sessions close <room> --org org_xxx

# Agent management
anvil livekit agent list --org org_xxx        # List agents
anvil livekit agent status --org org_xxx      # Agent status
anvil livekit agent versions --org org_xxx    # Agent versions
anvil livekit agent logs --org org_xxx        # Agent logs
anvil livekit agent restart --org org_xxx     # Restart agent
anvil livekit agent delete --org org_xxx      # Delete agent

# Agent secrets
anvil livekit agent secrets list --org org_xxx
anvil livekit agent secrets set --org org_xxx --secret KEY=VALUE
anvil livekit agent secrets delete <name> --org org_xxx

Forge（バージョン管理）

anvil forge versions                  # List forge versions
anvil forge branches                  # List forge branches
anvil forge commits main              # List commits on branch
anvil forge validate main             # Validate a git ref

動画処理

anvil video generate-moment --video-url <url>         # Start moment generation
anvil video generate-moment --video-url <url> --watch  # Generate and poll
anvil video generate-journey --video-url <url>         # Start journey generation
anvil video job-status <jobId>                         # Check job status

ユーティリティ

anvil health                         # API health check
anvil health --db                    # Include database health
anvil connect <agent-slug>           # Get LiveKit connection details
anvil api GET /agents                # Raw API request
anvil api POST /agents -d '{"name":"test"}'
anvil version                        # Print version info

Config-as-Code ワークフロー

設定をプルし、ローカルで編集して、検証してからプッシュします。

# Pull the current config
anvil config pull <config-id> -o agent.yaml

# Edit the YAML file
$EDITOR agent.yaml

# Validate locally (no API call needed)
anvil config validate agent.yaml

# See what changed
anvil config diff agent.yaml --id <config-id>

# Push the updated config
anvil config push agent.yaml

MCP サーバー（AI アシスタント向け）

Anvil には、Claude Code、Cursor、Windsurf などの AI コーディングアシスタント向けに、MCP サーバー（Sable ツール 28 個と HyperDX のオブザーバビリティツール 5 個）が含まれています。

初回セットアップ

anvil auth login --token svc_your_token     # Sable API credentials
anvil settings set-hyperdx hdx_your_key     # HyperDX API key (optional)

Cursor に追加

ブラウザーに貼り付けると、ワンクリックでインストールできます。

cursor://anysphere.cursor-deeplink/mcp/install?name=sable&config=eyJjb21tYW5kIjoiYW52aWwiLCJhcmdzIjpbIm1jcCIsInNlcnZlIl19

または、.cursor/mcp.json に手動で追加します。

{
  "mcpServers": {
    "sable": {
      "command": "anvil",
      "args": ["mcp", "serve"]
    }
  }
}

Claude Code に追加

claude mcp add sable -s user -- anvil mcp serve

設定にシークレットを記載する必要はありません。anvil は ~/.config/anvil/ から認証情報を読み込みます。

その他のエディター（Windsurf など）

同じ JSON 設定を、エディターの MCP 設定ファイルに追加してください。

Sable ツール（28）

ドメイン	ツール
エージェント	list_agents, get_agent, create_agent, update_agent, delete_agent
ジャーニー	list_journeys, get_journey, create_journey, update_journey, delete_journey
ナレッジベース	list_knowledge_base, get_knowledge_base_item, search_knowledge_base, import_knowledge_base_url, delete_knowledge_base_item, sync_knowledge_base_item
設定	list_configs, get_config
デプロイ	get_deploy_history, trigger_deploy, rollback_deploy
トランスクリプト	list_transcripts, get_transcript
分析	get_session_analytics, get_stage_analytics
ユーティリティ	check_health, get_connection_details, raw_api_request

HyperDX オブザーバビリティツール（5、オプション）

anvil settings set-hyperdx <key> を実行した場合、または環境変数 HYPERDX_API_KEY が設定されている場合に有効になります。

ツール	用途
hdx_search_events	集計、時間範囲、フィルター、グループ化を指定してログ／スパンをクエリします
hdx_query_metrics	メトリクス（Sum、Gauge、Histogram）をクエリします
hdx_list_dashboards	HyperDX ダッシュボードの一覧を取得します
hdx_get_dashboard	チャート定義を含むダッシュボードを取得します
hdx_list_alerts	設定済みアラートの一覧を取得します

新しいバージョンのリリース

Anvil は、自動リリースに goreleaser と GitHub Actions を使用します。

リリースの作成

git tag v0.1.0
git push origin v0.1.0

GitHub Actions が自動的に次の処理を行います。

1. Linux、macOS、Windows 向けのバイナリをビルドします（amd64 + arm64）
2. ダウンロード可能なアーカイブを含む GitHub リリースを作成します
3. チェックサムと変更履歴を生成します
4. Homebrew tap（sable-inc/homebrew-tap）に公開します
5. MCP Registry に公開します（Claude Code / Cursor で検出可能）

その後、チームメンバーは次の方法でアップグレードできます。

# Homebrew
brew upgrade anvil

# Go install
go install github.com/sable-inc/anvil/cmd/anvil@latest

スナップショットビルド（ローカルテスト）

goreleaser --snapshot --clean
ls dist/

開発

make build     # Build binary
make test      # Run tests with race detector
make lint      # Run golangci-lint v2
make check     # Build + test + lint
make install   # Install to $GOPATH/bin
make generate  # Generate API client from OpenAPI spec
make clean     # Remove build artifacts

必要なもの：

• Go 1.26+
• golangci-lint v2（make lint 用）
• 実行中の sable-api インスタンス（make generate 用）

CI/CD

GitHub Actions は次の処理を自動的に実行します。

• CI（.github/workflows/ci.yml）：プッシュおよび PR ごとにビルド、テスト、lint を実行します
• リリース（.github/workflows/release.yml）：バージョンタグ（v*）で goreleaser を実行します