こんにちは、最近Zettelkasten（ツェッテルカステン）を使った知識管理にハマっている @kyooooonaka です！
手書きのノートやObsidianのようなGUIツールも良いのですが、
CLIで軽量かつ柔軟に管理できるツールが欲しい！ と思い、
Goで 「Zettelkasten-cli (zk)」 を開発しました 💻✨
この記事では、Zettelkasten-cli の 特徴・機能・実装のポイント を紹介します！
📌 なぜ CLI で Zettelkasten を管理したかったのか？
🟢 軽量 & 高速 → GUI不要、ターミナルから即アクセス
🟢 カスタマイズ性 → 設定次第でどんなワークフローにも適用可能
🟢 スクリプトやGit管理と相性が良い → コマンド単位で自動化できる
🟢 ObsidianやNotionに依存しない → 独自の知識管理システムを構築できる
Zettelkasten のメモは テキストベース（Markdown） なので、CLIで操作できると最強！
「じゃあ 自作してみよう！」ということで開発を開始しました。
💡 Zettelkasten-cli (zk) の特徴
zk は、CLI で メモ・タスク・プロジェクトを管理 できるツールです。
「知識を整理し、リンクでつなぎ、タスクと統合する」 という Zettelkasten の原則を基に設計しました。
✅ ノートの作成・編集・検索・整理（Zettelkasten の 3種類のメモに対応）
✅ タスクの管理（メモ内にタスクを作成、進捗管理）
✅ プロジェクトとの関連付け（タスクとノートをプロジェクト単位で管理）
✅ ローカル環境でシンプルに動作（fzf との連携で快適検索）
✅ S3連携でデバイス間同期も可能
⚙️ インストール方法
1️⃣ go install でインストール（Go 環境がある場合）
go install github.com/nakachan-ing/Zettelkasten-cli/tree/pre-release
$GOBIN を PATH に追加するのを忘れずに。
2️⃣ GitHub Releases からバイナリをダウンロード
Mac/Linux
wget https://github.com/nakachan-ing/Zettelkasten-cli/releases/download/v3.0.0/zk-linux
mv zk-mac /usr/local/bin/zk
chmod +x /usr/local/bin/zk
Windows (PowerShell)
Invoke-WebRequest -Uri "https://github.com/nakachan-ing/Zettelkasten-cli/releases/download/v3.0.0/zk.exe" -OutFile "C:\Program Files\zk.exe"
🚀 zk の使い方
📝 1. ノートの作成・管理
# 一時的なメモ（Fleeting）
zk fleeting new "GoでCLIツールを作る"
# 永続的なメモ（Permanent）
zk permanent new "CLIの設計パターン"
# 文献メモ（Literature）
zk literature new "『Clean Architecture』の要点"
# 全ての Fleeting Notes を表示
zk fleeting list
# タグを指定して検索
zk fleeting list --tag programming
# 期間を指定して表示
zk permanent list --from 2024-01-01 --to 2024-12-31
# キーワード検索
zk literature list --search "マイクロサービス"
# タグで検索
zk search --tag devops
# タイトルで検索
zk search --title "CLI"
# 文脈を含めて検索
zk search --context 5 --interactive
✅ 2. タスクの管理
# ノート内にタスクを追加
zk task add 123 "GoでZettelkastenを実装する"
# タスクの一覧を取得
zk task list
# タスクのステータスを変更
zk task status 123 Done
📂 3. プロジェクトと関連付け
# プロジェクトを作成
zk project new "Go CLI Development"
# ノートをプロジェクトに追加
zk project add 123 "Go CLI Development"
🗂 4. ノートの整理
# ノートを削除（ゴミ箱へ移動）
zk delete 123
# ノートをアーカイブ
zk archive 123
# ノートを復元
zk restore 123
🔄 5. ノートの同期
# ローカルのメモと zettel.json を同期
zk sync
⚙️ zk の設定 (config.yaml)
デフォルトの設定ファイルは以下に配置されます。
-
Mac/Linux:
~/.config/zettelkasten-cli/config.yaml -
Windows:
~\APPDATA\zettelkasten-cli\config.yaml
カスタマイズ例：
note_dir: ~/Zettelkasten
editor: vim
zettel_json: ~/.config/zettelkasten-cli/zettel.json
archive_dir: ~/Zettelkasten/archive
sync:
enable: true
platform: s3
bucket: zettlr
aws_profile: default
設定ファイルを開いて編集：
zk config
🔍 実装のポイント
1️⃣ fzf を使ったノート検索
検索時に fzf を活用することで、インタラクティブな検索を実現。
cmd := exec.Command("fzf")
cmd.Stdin = strings.NewReader(listNotes())
cmd.Stdout = os.Stdout
cmd.Run()
2️⃣ zettel.json を利用したメモのメタデータ管理
全ノートのメタ情報を JSON に保存し、検索を高速化。
type Zettel struct {
ID string `json:"id"`
Title string `json:"title"`
Tags []string `json:"tags"`
}
🎯 まとめ
✅ CLI で Zettelkasten を管理できる「zk」を開発！
✅ ノートの作成・検索・リンク・タスク管理がすべてCLIで完結！
✅ シンプルな設定でカスタマイズ性が高い！
✅ fzf を活用した快適なノート検索！
🚀 「GUIよりもCLI派」の人におすすめ！
「試してみたい！」と思った方は、ぜひ GitHub からダウンロードしてください！ 🎉
📢 参考
「CLIで知識を整理したい！」という方、ぜひ zk を試してみてください！ 📝🔥