ハクソク

世界を動かす技術を、日本語で。

Backlog.md – Gitリポジトリ向けのMarkdownネイティブタスクマネージャーおよびカンバンビジュアライザー

323日前原文(github.com)

概要

Backlog.md は、 Markdownベース のタスク管理と Kanban可視化 をGitリポジトリで実現するCLIツール。 完全オフライン・プライベート 運用が可能で、 Web UI も提供。 クロスプラットフォーム 対応、MITライセンスの オープンソース。 CLIとWebで 直感的なタスク操作 が可能。 AI連携や高度なクエリ もサポート。

Backlog.mdの特徴

  • Markdownネイティブ のタスク管理
    • 各タスクは .mdファイル として保存
  • 完全プライベート＆オフライン運用
    • データは リポジトリ内 に完結
  • ターミナルで即時Kanban表示
    • CLIから ライブボード を描画
  • モダンなWebインターフェース
    • 直感的なUI でタスク管理
  • AI対応CLI
    • 例: "Claude, please take over task 33"
  • 豊富なクエリコマンド
    • タスクの 一覧・絞り込み・アーカイブ
  • クロスプラットフォーム対応
    • macOS、Linux、Windows で動作
  • MITライセンス・オープンソース
    • 個人・商用ともに無料利用 可能

5分で体験：クイックスタート

  • インストール
    • npm i -g backlog.md または bun add -g backlog.md
  • リポジトリの初期化
    • backlog init hello-
  • タスクの作成
    • backlog task create "Render markdown as kanban"
  • Kanbanボードの表示
    • backlog board view
  • データ保存形式
    • backlogフォルダ配下の Markdownファイル （例: task-12 - Fix typo.md）

Webインターフェース

  • Webサーバー起動
    • backlog browser（自動でブラウザが開く）
    • backlog browser --port 8080（ポート指定）
    • backlog browser --no-open（自動起動なし）
  • 主な機能
    • ドラッグ＆ドロップ対応Kanbanボード
    • タスク作成・編集 （バリデーション付きフォーム）
    • リアルタイム更新
    • レスポンシブデザイン （PC・モバイル対応）
    • タスクのアーカイブ （確認ダイアログ付き）
    • CLIとのシームレス同期

CLIリファレンス（主要操作）

  • タスク作成

    • backlog task create "Add OAuth System"
    • 説明・担当・状態・ラベル・優先度・計画・受け入れ基準・依存・サブタスク・ドラフト など各種オプション指定可能

  • タスク一覧

    • backlog task list [-s <status>] [-a <assignee>]

  • タスク詳細表示・編集

    • backlog task 7（UI表示、Eキーでエディタ編集）
    • backlog task edit 7 -a @sara -l auth,backend

  • タスクのアーカイブ

    • backlog task archive 7

  • ドラフト管理

    • backlog draft create "Spike GraphQL" → backlog draft promote 3.1
    • backlog task demote <id>（ドラフト化）

  • Kanbanボード表示

    • backlog board（CLI UI）

  • Web UI起動

    • backlog browser（ポート指定や自動起動オプションも可）

  • 設定編集

    • backlog config set defaultEditor "code --wait"
    • backlog config list（設定一覧）

  • ヘルプ表示

    • backlog --help

設定とカスタマイズ

  • 設定ファイルの優先順位
    • CLIフラグ > backlog/config.yml（プロジェクト単位） > ~/backlog/user（ユーザー単位） > ビルトイン
  • 主な設定キー
    • default_assignee：デフォルト担当者
    • default_status：最初のカラム名（例: To Do）
    • statuses：ボードのカラム（例: [To Do, In Progress, Done]）
    • date_format：日付フォーマット（例: yyyy-mm-dd）
    • default_editor：エディタ（nano, notepadなど）
    • default_port：Web UIのポート番号（デフォルト6420）
    • auto_open_browser：Web UI自動起動（true/false）
    • remote_operations：リモートgit操作有効化（falseで完全オフライン）

ライセンス

  • MITライセンス
    • 商用・個人問わず自由利用
    • クレジット表記のみ必須
    • 詳細は LICENSE 参照

Hackerたちの意見

数ヶ月前にClaude Codeを既存のコードベースに投げてみたんだけど、すぐに辞めちゃった。出力を整理するのが、ゼロから書くよりも遅かったんだよね。結局、解決策はプロセスであって、モデルの性能じゃなかった。 イテレーションタイムライン ================== • 50% タスク成功 - README.mdとCLAUDE.mdを追加して、モデルがプロジェクトを理解できるようにした。 • 75% - タスクごとに1つのマークダウンファイルを作成；Codexプラン、Claudeコード。 • 95% + - Backlog.mdを作成、ハイレベルな仕様を自動的にタスクファイルに変換するCLI（そう、ツールを作るのにClaude/Codexを使った）。 自分に合った3ステップループ

  1. タスク生成 - Codex / Claude Opus → セルフレビュー。
  2. プラン生成 - 同じエージェント、「プラン」モード → 必要に応じて調整。
  3. 実装 - Claude Sonnet / Codex → レビュー＆マージ。 シンプルな機能なら、これをスマホからでも実行できるよ：ChatGPTアプリ（Codex）→ GitHubアプリ → ChatGPTアプリ → GitHubマージ。 リポジトリ: https://github.com/MrLesk/Backlog.md フィードバックもらえると嬉しいし、質問にも答えるよ！
└

これめっちゃいいね！実際にタスクを作成、計画、実装するエンドツーエンドの例を動画で見てみたいな。

└

Claudeとの統合についてもっと詳しく知りたいな。Claudeにバックログを使ってXタスクを計画するように言ってるの？MCP統合みたいな感じで、もっとネイティブに感じられるかも？でも、ClaudeにMCPをネイティブで使わせるのはあんまりうまくいってないから、ちょっと外れてるかもね、笑。

└

同じ経験があるよ。Taskmaster-aiは結構良かったけど、プロジェクトが大きくなるとエージェントが無視することもあった（今はClaudeコードフックを使えば防げるかも）。今日このプロジェクトを試してみるのは良さそうだね。サブタスクもあるみたいだけど、「依存関係」についての考えはある？つまり、タスクAが未完了の場合はXをやらないとか。ちなみに、AGENTS.mdやGEMINI.mdに404があって、存在しないREADME.mdを指してるよ。

└

おお、すごい仕事だね！君はレジェンドだよ！

いいアイデアだね。でも、あなたのスクリーンショットにはプロジェクト内にたくさんのタスクが表示されてるけど、タスクを（計画した後に）エージェントにどうやって振り分けてるの？それに、エージェントは大量のマークダウンタスクコンテンツをどうやって処理してるの？コンテキスト予算を超えないように。

└

タスクの割り当ては、ただ「クロード、タスク123を引き受けてくれ」とお願いするだけ。埋め込まれたカスタム指示のおかげで、クロードはどう進めればいいかをちゃんとわかってる。大きなタスクは作らないから、実際に文脈を圧迫するのはドキュメントや決定のマークダウンファイルなんだよね。

タイトルをAI用のツールだと含めるように変更できないかな？ただのビジュアライザーになると思ってた。リポジトリのタグラインはいい感じだね：「人間とAIエージェントのプロジェクトコラボレーションを管理するためのツール、gitエコシステム内で」。

自分でも似たようなツールを作ったよ。依存関係なしのシンプルなPythonスクリプトで、リポジトリのルートにある「tasks.md」をパースして、タスクのマークダウンテーブルを含んでる。それから、BLOCKED/READY/DONE/CANCELLED、依存関係、タイトル、タグなどの基本的なサポートもある。自分用のプロジェクトには、まさに必要なもの – 依存関係の追跡だけで、あとはオフラインでコードと一緒に保存してる。ほとんどのコードはGeminiが書いたよ。

└

うん、どんどん多くの人が似たようなプロセスに向かってるって聞いて嬉しいよ。これが一番生産的だからね。

aiderを使えば、--watch-filesと一緒に2つ目のインスタンスを動かせるし、タスク内で// #AIって書くとチャットに追加される。// !AIって書くとAIが反応するから、例えばbacklog task create "Feature" --plan "1. Research\n2. Suggest Implementation// #AI AI!"って感じで（そう、！の順番は変だけど）その裏でaiderが解決策を提案してくれる。Claude CodeやCodexと比べてどうかはわからないけど、LLMに柔軟だよ。ただ、プルリクエストは作成しないから、ローカルコードにはもっと役立つかな。多分、--watch-filesセッションにReadme.mdファイルを追加した方がいいと思うし、[D]ont ask againを一度クリックすれば、ファイル追加の確認が続かなくなるよ。

ああ、これがJiraの後の未来ってわけか。

これはいい実装だね。個人的には、https://www.task-master.devを使ってるよ。

このプロジェクトをgitにファイルをコミットせずに使う方法ってある？今やってるプロジェクトで試してみたいんだけど、履歴に残したくないんだ。やったのは、backlogフォルダを.gitignoreファイルに追加することだけど、コマンドを実行するたびにgitコマンドエラーの長いエラーが出るんだ。もしこれらのファイルをリポジトリに追加することになったら、手動で追加したいんだよね。

└

サブレポ？

└

自動コミットを追跡しているGHの問題があって、作者が今日中に解決するって言ってるよ。

└

エイダーとの使い方についてのコメント見てね。

Markdownネイティブタスク -- すべての問題をプレーンな.mdファイルとして管理 > リッチクエリコマンド -- タスクを簡単に表示、リスト、フィルタリング、アーカイブできる これらのことに興味があるなら、まだ見ていないならGitHub CLIツールのghはすごく便利だよ。例えば：gh repo clone MrLesk/Backlog.md cd Backlog.md gh issue view 140 gh issue view 140 --json body --template "{{.body}}" — https://cli.github.com リポジトリをフォークしたり、現在のブランチからプルリクエストを開いたりできるよ。

いいね！これチェックしてみるよ。最近、SQLiteを使ってリポジトリの外に保存するNonlinearっていう似たようなMCPシステムを作ったんだ（めっちゃ賢い）。でも、正直言うとリポジトリ内にある方がいいと思う。