ターミナルでの作業は、ステップごとにコードハイライト効かせて手順書を作ることが多いのですが、手順が長いと結構しんどい作業です。

かといって YouTube で動画撮ってもコピペできるわけじゃないし、script コマンドとかは vim とか tmux の全画面を書き換えるようなコマンドを使うとぶっ壊れで再現できません。

そこでターミナルでの作業を記録、共有してくれるサービス、asciinemaです。まずはdemoをどうぞ

このdemoだけで大体使い方わかっちゃいますね。埋め込みもできて、さらにコピペもできます。すごく使いやすい！

tmux起動して256カラー出して、vim起動して、、いろいろやってもまず記録がおかしくなることはありませんでした

使い方も超簡単 asciinema rec で記録を開始したら、exitするまで記録してくれます。その後、 upload するかローカルに保存するか聞いてきます。uploadする場合はデフォルトは private になってるので URL が流出しない限りまあ大丈夫です。

自分の環境のターミナルで再生もできます。これが地味に便利！

アカウントを作る（メールアドレス入力するだけでパスワードなど不要）と記録したセッション一覧を管理できます。このあたりの仕組みを調べていた方がいたので詳細はそちらをどぞ。

PIB hack のためのネタ帳, etc,,, asciinema

セッションの内容はtextファイルなので、神経質な方は中身をチェックしてから upload してもいいかもしれません。

追記: redmineで asciinema を埋め込めるように Redmine の Plugin の additionals に pull req 送ったら merge してもらえました！

Added asciinema.org macro #70