pickfit

瀏覽開發者 CLI

atago

依 YAML 規格測試實際 CLI 行為,檢查結束碼、輸出、檔案與終端機。

已在 macOS 和 Linux 上測試

使用

macOS arm64

需要先準備

  • 執行環境:Go 1.26.10 or later
  1. 透過 brew cask nao1215/tap/atago 安裝 atago

    brew install --cask nao1215/tap/atago

確認能用

atago --version

輸出應包含「atago v0.25.2」。

先試試這個

cat > f1.atago.yaml <<'YAML'
version: "1"
suite:
  name: example
scenarios:
  - name: echo greets the world
    steps:
      - run:
          shell: true
          command: echo "hello atago"
      - assert:
          exit_code: 0
          stdout:
            contains: atago
          stderr:
            empty: true
YAML
cat > f2.atago.yaml <<'YAML'
version: "1"
suite:
  name: files
scenarios:
  - name: the generator writes the expected files
    steps:
      - run:
          shell: true
          command: mkdir -p site && echo "<html>hello</html>" > site/index.html
      - assert:
          file:
            path: site/index.html
            contains:
              - "<html"
YAML
cat > f3.atago.yaml <<'YAML'
version: "1"
suite:
  name: pty-test
scenarios:
  - name: the init wizard completes
    steps:
      - pty:
          command: sh -c 'printf "Project name: "; read name; echo "created $name/"'
          session:
            - expect: "Project name:"
            - send: "demo\n"
            - expect: "created demo/"
      - assert:
          exit_code: 0
YAML
cat > /tmp/prompt.sh <<'SH'
#!/bin/sh
printf "Project name: "
read name
echo "created $name/"
SH
chmod +x /tmp/prompt.sh
echo "setup done" && ls -lh *.atago.yaml
atago run f1.atago.yaml

撰寫 YAML 規格檔,再以 atago run <spec>.atago.yaml 執行。

Linux x86_64

需要先準備

  • 執行環境:Go 1.26.10 or later
  1. 從 releases 下載預建的 linux_amd64 tarball,並將 atago 安裝至 ~/.local/bin

    mkdir -p ~/.local/bin /tmp/atago-dl && curl -fsSL -o /tmp/atago-dl/atago.tar.gz https://github.com/nao1215/atago/releases/download/v0.25.2/atago_0.25.2_linux_amd64.tar.gz && tar -xzf /tmp/atago-dl/atago.tar.gz -C /tmp/atago-dl && install -m 0755 /tmp/atago-dl/atago ~/.local/bin/atago && ~/.local/bin/atago --version

確認能用

atago --version

輸出應包含「atago v0.25.2」。

先試試這個

mkdir -p specs && cat > specs/f1.atago.yaml <<'YAML'
version: "1"
suite:
  name: example
scenarios:
  - name: echo greets the world
    steps:
      - run:
          shell: true
          command: echo "hello atago"
      - assert:
          exit_code: 0
          stdout:
            contains: atago
          stderr:
            empty: true
YAML
cat > specs/f2.atago.yaml <<'YAML'
version: "1"
suite:
  name: files-example
scenarios:
  - name: the generator writes the expected files
    steps:
      - run:
          shell: true
          command: mkdir -p site && echo "<html>hello</html>" > site/index.html && cat site/index.html
      - assert:
          file:
            path: site/index.html
            contains:
              - "<html"
YAML
cat > specs/f3.atago.yaml <<'YAML'
version: "1"
suite:
  name: pty-example
scenarios:
  - name: the init wizard completes
    steps:
      - pty:
          command: sh -c 'printf "Project name: "; read name; echo "created $name/"'
          session:
            - expect: "Project name:"
            - send: "demo\n"
            - expect: "created demo/"
      - assert:
          exit_code: 0
YAML
ls -la specs/ && cat specs/f1.atago.yaml
atago run specs/f1.atago.yaml

撰寫 YAML 規格檔,再以 atago run <spec>.atago.yaml 執行。

它能做什麼

  • 操作互動式提示與終端機介面
    怎麼使用
    1. 在規格檔中新增 pty 步驟,包含要執行的 command,以及由 expect 與 send 項目組成的 session 清單。
    2. 新增 assert 步驟,例如 exit_code: 0。
    3. 以 atago run <spec>.atago.yaml 執行規格。
    已測試
  • 將實際指令執行過程錄製為測試規格
    怎麼使用
    1. 以 atago record --out <spec>.atago.yaml -- <command> 錄製指令。
    2. 以 atago run <spec>.atago.yaml 重播錄製的規格。
    已測試
  • 檢查指令的結束代碼、stdout 與 stderr
    沒有看到它可用
  • 檢查產生的檔案並比對快照
    沒有看到它可用

pickfit 測到哪一步

macOS arm64

  1. 可以安裝
  2. 可以啟動
  3. 4 項功能中 2 項可用
  4. 可離線使用

Linux x86_64

  1. 可以安裝
  2. 可以啟動
  3. 4 項功能中 1 項可用
  4. 可離線使用

Windows:專案說支援,但 pickfit 還沒試過。

適合用來

  • 檢查指令的結束代碼、stdout 與 stderr
  • 檢查產生的檔案並比對快照
  • 透過 PTY 操作互動式提示與 TUI
  • 將實際執行錄製成測試規格
  • 搭配背景伺服器測試 CLI

可替代 runn、venom、ShellSpec 和 Bats。

pickfit 怎麼測的

每次測試都從乾淨的機器開始,照上面的步驟執行。 pickfit 怎麼驗證

macOS arm64

主要功能可用

  • 從頭重跑
  • 可離線使用
  • 檢查於 2026年11月1日
  • 版本 v0.25.2

測試機器遇到的差異

  • README: brew install --cask nao1215/tap/atago
    測試中: brew 警告「Calling `postflight` is deprecated! Use `postflight_steps` instead」,但安裝仍成功,執行檔已連結至 /opt/homebrew/bin/atago

Linux x86_64

主要功能可用

  • 從頭重跑
  • 可離線使用
  • 檢查於 2026年10月30日
  • 版本 v0.25.2

測試機器遇到的差異

  • README: go install github.com/nao1215/atago@latest (requires Go 1.26.10+); yay -S atago-bin; aqua g -i nao1215/atago; mise use -g aqua:nao1215/atago
    測試中: 從 GitHub releases 頁面下載 atago_0.25.2_linux_amd64.tar.gz(README 有說明),並將 atago 執行檔安裝至 ~/.local/bin
  • README: README wizard example uses a bare command without ': ' so needs no quoting
    測試中: 含有「: 」的 pty/run 指令值須以雙引號括起,否則載入時會以 ATG2003 失敗

怎麼看工具卡

縫線
pickfit 親自安裝過這款工具,縫線下方的內容都來自那次測試。沒測過的工具,一律沒有縫線。
已在你的作業系統上驗證
安裝步驟在你選的系統上跑過。「只在 Linux 上執行過」表示還沒在你的系統上跑過。
macOS、Linux 和 Windows在哪裡測過
綠色系統標記:pickfit 在該系統跑過安裝步驟。灰色:README 說支援,但 pickfit 還沒試過。
測試進行到哪一步
能安裝並啟動、主要功能可用、服務有回應、能產生模型輸出。視窗代表桌面應用程式已開啟;插頭代表 MCP 用戶端用過它。標記在測試結果旁邊:展開「為什麼適合、我們怎麼知道」,或在「pickfit 怎麼測的」裡。
視覺檢查
pickfit 看過應用程式的截圖。綠色:畫面正常。黃色加數字:有看起來不對的地方,點開就能看到。灰色虛線:還沒檢查。
已知漏洞
它安裝的套件有沒有已知的高風險或嚴重漏洞(OSV.dev)。綠色:沒有已知漏洞。紅色加數字:有幾個,點開看清單,安裝前先看過。灰色虛線:沒有檢查,不代表安全。
關於這次測試
測試日期,以及測到的版本。
理由的來源
每個推薦理由都依據簡介裡的一個欄位。展開理由就能看到欄位和值。
寶藏
品質高、少有人知。
品質與知名度
兩個分數,滿分都是 100。品質:pickfit 試裝、試用的結果,以及安裝文件和維護狀況。知名度:看星數、下載量和 Hacker News。
已檢查的功能
README 宣傳的主要功能裡,實測通過幾項(綠色)、失敗幾項(紅色)。灰色是沒檢查的,工具卡會說明原因。
未驗證
Fitz 依一般知識提到的知名工具。沒有測試紀錄、沒有步驟、沒有分數。