antiwork/shortest

自然言語でAIが実行するエンドツーエンドテストフレームワーク

インストール型ツール自由に使える · MIT自動化・ワークフローTypeScript難易度
5,6840 保存
344フォーク0Issue
デモ・公式サイトをひらくshortest.com

中辛 の解説

Shortest は TypeScript・Next.js・Playwright・Anthropic Claude API を組み合わせたテストフレームワークです。難易度は中程度で、npm コマンド 1 つで初期設定でき、すぐに自然言語テストを書き始められます。GitHub 2FA・Mailosaur メール検証・ライフサイクルフック・テストチェーン・API テストをサポートしており、CI/CD パイプラインでのヘッドレス実行も可能です。

こんなリポジトリです

こんなときに便利です

  • Web アプリケーションのユーザーログイン・登録フローの自動テスト
  • GitHub 2FA 認証を含む複雑な認証シナリオの検証
  • API エンドポイントと UI の統合テスト

主な機能

自然言語によるテスト記述AI による自動実行と推論GitHub・メール認証・ライフサイクルフックのサポート

ほかとの違い

従来のテストコードと異なり、テストロジックを記述せずに自然言語の指示のみで E2E テストを構築でき、AI キャッシュにより複数テスト間の実行効率と コスト削減を実現しています。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

準備するもの

  • Node.js
  • npm / pnpm
  • Anthropic API キー

すぐに始める

  1. 初期化コマンドを実行し、プロジェクトにパッケージ・設定ファイル・環境変数をセットアップします。
npx @antiwork/shortest init
  1. .env.local ファイルを編集し、Anthropic API キーを設定します。
ANTHROPIC_API_KEY=your_api_key
  1. shortest.config.ts でテスト対象の URL とパターンを指定します。
import type { ShortestConfig } from "@antiwork/shortest";

export default {
  headless: false,
  baseUrl: "http://localhost:3000",
  testPattern: "**/*.test.ts",
  ai: {
    provider: "anthropic",
  },
} satisfies ShortestConfig;
  1. テストファイル (app/login.test.ts など) を自然言語で記述します。
import { shortest } from "@antiwork/shortest";

shortest("ユーザー名とパスワードでログインする", {
  username: process.env.USERNAME,
  password: process.env.PASSWORD,
});
  1. テストを実行します。
pnpm shortest
  1. (オプション) GitHub 2FA を使用する場合は、OTP シークレットを設定して認証します。
shortest --github-code --secret=<OTP_SECRET>

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try antiwork/shortest

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

5,6847日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

まねしやすいサンプル評点 50/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2024 年に作成

「自動化・ワークフロー」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/antiwork/shortest.svg)](https://www.gitbap.com/r/antiwork/shortest)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る