クイックスタート

ゼロから合格するシミュレーションまで 3 ステップで。suya CLI がすべてを操作します — 人間にも、AI エージェントにも、CI にも同じように。

1. CLI をインストールする

# macOS / Linux
curl -fsSL https://subaya-dev.com/cli/install.sh | sh

# Windows
irm https://subaya-dev.com/cli/install.ps1 | iex

すべてのプラットフォームとチェックサムについては ダウンロード ページをご覧ください。次のコマンドで確認します:

suya version

2. サインインする

suya auth login

これはブラウザを開いて CLI を認可し、トークンをローカルに保存します。エージェントや CI の場合は、代わりに SUBAYA_API_KEY 環境変数を設定してください — ブラウザは不要です:

export SUBAYA_API_KEY="sk_..."
suya auth whoami

詳細は 認証と API キー をご覧ください。

3. 最初のシミュレーションを実行する

suya project create --name adder --workspace <workspace-id> --type fpga

suya sim run \
  --tool ryusim \
  --tb tb/adder_tb.py \
  --top adder \
  --source ./rtl \
  --wait

--source は RTL ツリーをパックしてクラウドの RyuSim 実行に送ります。--wait は実行が 終端状態に達するまでポーリングし、合否のサマリーを表示します。続いて:

• suya sim report <run-id> — 結果のサマリー
• suya sim logs <run-id> --follow — 実行ログをストリームする
• suya sim wave <run-id> — 波形アーティファクトの場所を特定する（wf で解析）
• suya sim list — 最近の実行

次はどこへ

• プロジェクトを開始 — プロジェクトの全体フロー
• GitHub リポジトリを接続 — プロジェクトを Git でバックする
• プロジェクトを計画する — アイデアをワークアイテムに変える
• STM32 はじめに — 組み込みの実践例