サイバーニューラ

Run and Log

Markdown に書いたシェルコマンドを実行し、結果を同じファイルに書き戻すツール。

AI エージェントが人にコマンドの実行を頼み、人が実行し、エージェントが結果を読む。その往復を 1 つのファイルの中に収めます。 IPython のノートブックのようにコマンドと結果が隣り合って並びますが、文書は素の Markdown のままです。

最新版をダウンロード

macOS は Homebrew でもインストールできます:

brew install --cask cyberneura/tap/runandlog

対応 OS: macOS (Apple Silicon) / Linux

github.com/cyberneura/runandlog

主な機能

  • shell / sh / bash / zsh のコードブロックをセルとして扱い、結果をそのブロックの直後に書き戻します
  • CLI (--list / --run N / --run-all)、TUI、デスクトップアプリ (--gui) の 3 通りで使えます
  • 実行中の出力はコマンドの終了を待たずに表示します。長い出力 (既定 50 行超) は別ファイルに書き出し、本文にはリンクを残します
  • sudo / ssh / HTTPS の git がパスワードを求めたときは、askpass ヘルパーが端末・TUI・ダイアログで質問します。答えはコマンドにだけ渡り、Markdown には書き込みません
  • セルごとの時間制限 (--timeout)。期限が来たらプロセスグループごと止めます

動作環境・注意点

  • macOS 版は Apple Silicon 用で、デスクトップアプリ (GUI) を含みます。Developer ID で署名し Apple の公証を受けています。Homebrew の cask も Apple Silicon 専用です。
  • Linux 版は x86_64 の CLI / TUI のみで、GUI は含みません (glibc でビルドしています)。
  • crates.io からも cargo install runandlog で導入できます。
  • MIT License のオープンソースです。