HOW TO — 目次と全体像
素材を入れる。AI が編集する。開いて、直して、書き出す。——この一連の流れを、インストールから完成動画まで、初めての人にもわかる順番で全部説明します。GitHub を読まなくても、ここだけでひととおり使えるようになるのがこのガイドの目標です。
1 — 30 秒でわかる AKARI Video
AKARI Video は AI エージェントが動画編集をやるためのシステムです。カット・テロップ・字幕・BGM の組み立てはぜんぶ AI がやります。人間の仕事は 2 つだけ——作りたいものを伝えることと、節目で「それでいい」と確認すること。
編集の途中経過も結果も、ぜんぶ普通のファイルとしてあなたの PC に残ります。だから途中でやめても壊れないし、別の道具に乗り換えることもできます。ローカルで完結する範囲（文字起こし・編集・書き出し）は無料です。
exports/ に MP4 が保存される確認ポイントは既定で 2 箇所（編集方針・書き出し）。「全部おまかせ」にも「逐一相談」にも切り替えられます（→ はじめての 1 本）。
2 — 2 つの入口
入口は 2 系統ありますが、どちらで始めても中身（ファイル）は同じです。あとから行き来できます。
プログラミング知識ゼロで OK。無料の AI（opencode）で始められる。
いつものエージェントに、動画工場のスキルが 19 個生える。
/akari、opencode / Cursor は発話でedit.json。API なし・git 差分で追えるデスクトップアプリ（Mac・Public Beta）は「AI が作った編集を確認して直す場所」です。最初の一歩はターミナルかエージェントのセッションから始めるのが現在のおすすめです。
3 — このガイドの読み順
必要なもの・インストール 1 行・AI エージェントの選び方（無料の opencode / 有料の Claude Code）。
install → 2. はじめての 1 本プロジェクトを作って、素材を入れて、完成 MP4 が出るまで。実際に打つ言葉つき。
first-video → 3. 開いて、直すプレビューの開き方。ドラッグで動かす・ダブルクリックで文字を直す・ツマミで調整する。
viewer → 4. ファイルの地図PC の中のどこに何ができるのか。誰が触ってよいのか。引っ越し・バックアップはどうするか。
files → 5. Claude Code / Codex から使うスキル 19 個の一覧・CLI・edit.json の思想・他の編集ソフトへの書き出し（BETA）。
power → 6. つまずいたらよくある質問と、質問できる場所（LINE オープンチャット・Discord・GitHub）。
faq →4 — このガイドについて
AKARI Video は開発中のプロダクトで、画面や手順は速いペースで変わります。だから各ページの上下に「最終更新日」と「その時点のアプリバージョン」を必ず入れています。手元のアプリとこのガイドの表示が食い違ったら、ガイドが古い可能性が高いです——GitHub のドキュメントが常に最新の正本です。
| 日付 | 対応バージョン | 内容 |
|---|---|---|
| 2026-08-03 | v0.1.3 | 初版公開（全 7 ページ） |
もっと詳しく知りたいとき — このガイドは「使う人」向けの説明です。データ形式の仕様（契約）・スキルの内部手順・開発者向け情報は、GitHub リポジトリの docs/ にすべて公開されています。