Skip to content

README.ja.md

Latest commit

 

History

History
130 lines (96 loc) · 3.63 KB

README.ja.md

File metadata and controls

130 lines (96 loc) · 3.63 KB

lazysfn

AWS Step Functionsの情報をターミナルから確認できるTUIツール。lazygit風のUI/UXでStep Functionsの稼働状況を閲覧する。

2026-03-11.20.06.03.mov

English README

機能

  • AWS profileの選択（~/.aws/config から読み込み）
  • ステートマシン一覧の表示（Standardタイプのみ、名前ソート）
  • 直近の実行ステータスを色付き記号 ● で表示
  • 実行履歴の表示（実行ID、実行結果、失敗ステート、開始/終了時間、動作時間、Input Param）
  • 実行履歴のページネーション（スクロール末尾で自動的に次ページを読み込み）
  • 入力パラメータ詳細モーダル（実行履歴でEnter → JSON整形表示、j/kスクロール対応）
  • ステータスの色分け表示（SUCCEEDED: 緑、FAILED: 赤、RUNNING: 青、TIMED_OUT: 黄、ABORTED: グレー）
  • ステートマシン名のインクリメンタル検索
  • キーバインドヘルプの表示
  • 手動リフレッシュ
  • エラーモーダル表示（AWS接続エラー時、profile選択への復帰）
  • Vim準拠のキーバインド

技術スタック

インストール

go install

go install github.com/myuron/lazysfn@latest

GitHub Releases

Releases ページからビルド済みバイナリをダウンロードできます。

# 例: macOS (Apple Silicon)
curl -Lo lazysfn https://github.com/myuron/lazysfn/releases/latest/download/lazysfn-darwin-arm64
chmod +x lazysfn
sudo mv lazysfn /usr/local/bin/

対応バイナリ: lazysfn-darwin-amd64, lazysfn-darwin-arm64, lazysfn-linux-amd64, lazysfn-windows-amd64.exe

ビルド

git clone https://github.com/myuron/lazysfn
cd lazysfn
go build -o ./dist/lazysfn .

Nix

nix run github:myuron/lazysfn

flake inputとして追加する場合:

{
  inputs = {
    lazysfn.url = "github:myuron/lazysfn";
  };

  outputs = { self, nixpkgs, lazysfn, ... }: {
    # overlayを使って pkgs.lazysfn を追加
    nixosConfigurations.example = nixpkgs.lib.nixosSystem {
      modules = [{
        nixpkgs.overlays = [ lazysfn.overlays.default ];
        environment.systemPackages = [ pkgs.lazysfn ];
      }];
    };

    # またはパッケージを直接参照
    # lazysfn.packages.${system}.default
  };
}

キーバインド

グローバル

キー 動作
? キーバインドヘルプの表示 / 非表示
q 終了 / ポップアップを閉じる
R 更新

メイン画面

キー 動作
j / k カーソル下 / 上
h / l 左パネル / 右パネルにフォーカス
Tab パネル切り替え
Enter 入力パラメータ詳細を表示（右パネル）
/ インクリメンタル検索（左パネル）

検索モード

キー 動作
文字入力 検索文字列を更新し、リアルタイムで絞り込み
Esc 検索をキャンセル（全件表示に戻る）
Enter 検索を確定（フィルタを維持）

プロファイル選択

キー 動作
j / k カーソル下 / 上
Enter プロファイルを選択
q 終了

開発環境

Nix を使用。

nix develop