Fjord

Fjord は、プロジェクト、カンバンボード、ファイル、ノートを、ユーザー自身のマシン上にある単一の SQLite データベースに保存します。アカウントも、クラウドも、テレメトリーもありません。軽量なネイティブデスクトップアプリ（Tauri）、スクリプトから操作できる CLI、そしてMCP サーバーを備えているため、ユーザーと AI アシスタントが同じプロジェクトで作業でき、誰が何をしたかをいつでも確認できます。

特徴

• プロジェクトとカンバンボード — ドラッグ＆ドロップ、またはH／Lでタスクを移動できます。列の名前変更、色の変更、並べ替え、追加ができ、1つ以上の列を完了列（例：Resolved、Done）として設定できます。プロジェクトを右クリックすると、アイコンと色を変更できます。
• タスク — Markdown形式の説明、優先度、期限、期限超過の警告、アーカイブと復元に対応しています。サブタスクやファイルと一緒に別のプロジェクトへ移動したり、タスクを独立したウィンドウに表示してボードの横や別のモニターに置いたりできます。概要には、プロジェクト全体で今週が期限のタスクがすべて表示され、期限超過のタスクが先に表示されます。
• スタンドアップと対応待ち（ベータ） — スタンドアップの日には、概要で1つのプロジェクトのスタンドアップ（完了、進行中、自分のPR、メンションされた場所）が下書きされ、テキストとしてコピーできます。また、レビュー待ち、またはチェックに失敗したプルリクエストが一覧表示されます。どちらもデフォルトではオフです。有効にするには、Settings → Overviewで設定してください。ここでは、概要の各セクションを個別にオンまたはオフにできます。
• ファイル — ファイルをウィンドウにドロップすると、プロジェクトまたはタスクに添付できます。コンテンツアドレス方式で保存され（重複排除）、画像プレビューにも対応しています。
• テーマ — 組み込みテーマ5種類（Fjord Dark／Light、Nord、Solarized Light、High Contrast）から選択できます。OSの設定に従い、ライト／ダークを個別に選ぶことも、ライブプレビューで色、文字サイズ、角丸、表示密度を調整して独自のテーマを作成することもできます。テーマはJSON形式で共有できます。Space Tでテーマを切り替えられます。
• 対応待ち — クライアントからの返信など、誰かの対応を待っているタスクとして設定できます（w、右クリック、またはタスクパネルから操作）。タスクは元の列に残り、「pending 3d」バッジが表示され、フィルターで絞り込めます。概要には待ち時間の長い順に表示され、スタンドアップではブロッカーとして表示されます。Azure Boardsのタスクは作業項目と双方向に連動します。Azureで作業項目をPendingに設定するとFjordでも対応待ちになり、Fjordで対応待ちにすると作業項目も同じ状態になります（解除した場合も同様です）。
• サブタスク — タスクを独自のステータス、優先度、ブランチを持つサブタスク（1階層）に分割したり、既存のタスクを別のタスクのサブタスクにしたり（また元に戻したり）できます。カードには進捗（2/5）が表示されます。タスクパネルにはサブタスクが一覧表示され、チェックによる完了、ドラッグによる並べ替え、Aによる追加ができます。
• Notespace — ObsidianスタイルのMarkdownノートを、プロジェクト内または独立したノートとして、フォルダーやサブフォルダーで管理できます（ノートをフォルダーにドラッグ、名前または日付で並べ替え）。ピン留めや読み取り専用にロックできるノートにも対応しています。[[Project]]、[[#12]]（タスク）、[[Another note]]であらゆる項目にリンクできます。[[を入力すると自動補完が表示され、タスク、プロジェクト、ノートでバックリンク（「mentioned in」）を確認できます。ノートとタスクの説明では、表、タスクリスト、Mermaidの図が表示されます。Webリンクはブラウザーで開きます。
• タスク、ノート、ファイル名を対象にした全文検索（Space f）。
• キーボード優先 — which-keyポップアップ付きのリーダーキー、ボード上でのVim操作、Ctrl+Kのコマンドパレットを備え、すべてのキー割り当てを設定できます。マウスですべての操作を行うこともできます。
• Git、GitHub、Azure DevOps — プロジェクトをリポジトリにリンクし、タスクから慣例に沿った名前のブランチ（B、例：feat/12-add-login）を作成するか、既存のブランチをリンクできます。CIのステータス付きでプルリクエストを確認し、タスクからPRを開き、PRがマージされたらタスクを完了状態に移動できます。
• Azure Boardsからのインポート — 自分に割り当てられた作業項目が、選択したプロジェクトのタスクとして表示されます。状態は列にマッピングされ、子項目はサブタスクになり、添付ファイルやスクリーンショットも表示されます。ディスカッションもタスク内で確認できます。オプション（ベータ）として、ストーリー分析の受け入れ条件とリスクを作業項目に送信したり、ディスカッションに返信したりできます。誰かに@メンションされた作業項目は概要に表示されます。
• VS Code拡張機能 — Fjord for VS Codeを使うと、コードの横にボードが表示され、現在のブランチに対応するタスクがステータスバーに表示されます。VS Codeを参照してください。
• AIエージェント対応 — fjord mcpはClaude CodeやCursorなどのMCPクライアントに28個のツールを提供し、Agent Skillによってエージェントがその使い方を学べます。エージェントは作成、編集、移動、アーカイブを行えますが、完全削除はできません。また、すべての変更に作成者が記録されます。
• アクティビティログ — 何が、いつ、誰によって（自分またはエージェント）変更されたかを確認できます。
• ライブ更新 — CLIやエージェントによる変更は、開いているアプリに1～2秒以内に反映されます。
• 英語とノルウェー語 — デフォルトは英語です。言語の追加はファイル1つで行えます。
• 自動更新 — 署名済みのアプリ内更新に対応しています。Settingsにはインストール済みのバージョンが表示されます。

インストール

Fjord は Linux を優先しており、開発と日常的な使用は Linux 上で行っています。Windows と macOS のビルドは同じコードから作成され、すべてのプルリクエストで CI によるテストが実施されます。

ダウンロード

お使いのシステム用のインストーラーをリリースからダウンロードしてください。

システム	ファイル
Linux	.AppImage（任意のディストリビューション）、.deb（Debian/Ubuntu）、.rpm（Fedora/openSUSE）
Windows 10/11	.msi または -setup.exe
macOS	.dmg（Apple Silicon または Intel）

macOS では（また、Linux で CLI を使う場合は）、Homebrew も利用できます。

brew install --cask jhtjernsmo/fjord/fjord   # the app
brew install jhtjernsmo/fjord/fjord-cli      # the `fjord` command-line tool

CLI は fjord-cli-<platform> として別途添付されています。0.2.9 以降、macOS アプリは Apple Developer ID で署名され、公証されているため、通常どおり起動できます。Windows のビルドはまだコード署名されていないため、SmartScreen の警告が表示される場合があります（詳細情報 → 実行）。

ソースからビルド

必要条件： Rust（stable）、Node.js 20 以降。Linux では WebKitGTK 4.1 も必要です。Windows では組み込みの WebView2 を使用し、macOS では Xcode のコマンドラインツールが必要です。

# Arch
sudo pacman -S --needed webkit2gtk-4.1 base-devel
# Debian / Ubuntu
sudo apt install libwebkit2gtk-4.1-dev build-essential libssl-dev librsvg2-dev
# Fedora
sudo dnf install webkit2gtk4.1-devel openssl-devel librsvg2-devel

git clone https://github.com/jhtjernsmo/fjord.git
cd fjord
npm --prefix ui install
npx --prefix ui tauri build          # installers for your OS in target/release/bundle
./target/release/fjord-app           # run it

cargo install --path crates/fjord-cli  # optional: puts `fjord` on your PATH

ホットリロードを有効にした開発には、npx --prefix ui tauri dev を実行してください。

アップデート

0.2.1 以降、Fjord は起動時に GitHub Releases を確認し、アップデートして再起動を提案します（Windows、macOS、Linux AppImage が対象です。.deb／.rpm はパッケージマネージャー経由でアップデートしてください）。インストール前にアップデートの署名が検証されます。確認は設定で無効にできます。設定 → アップデートにはインストール済みのバージョンが表示され、今すぐ確認ボタンがあります。0.2.1 より前のバージョンにはアップデーターがないため、最新リリースを一度手動でインストールしてください。

キーボード

アプリ内で ? を押すと、すべてのショートカットを確認できます。リーダーキー（Space）を押して少し待つと、次に使えるキーが表示されます。

キー	操作	キー	操作
Ctrl+K	コマンドパレット	h j k l	ボード内を移動
Space p	プロジェクトを切り替え	H / L	タスクを前／次の列に移動
Space t	新しいタスク	J / K	タスクを下／上に移動
Space f	すべてを検索	Enter	タスクを開く
Space n	新しいプロジェクト	o	この列に新しいタスクを作成
Space b o F a A	ボード、ノート、ファイル、アクティビティ、アーカイブ	x	完了状態を切り替え
Space ,	設定	d d	タスクをアーカイブ
Space L	言語を切り替え	p	優先度を切り替え
Space N	Notespace	/	ボードをフィルタリング
Space g	Git タブ	B	タスクのブランチを作成
Space r	プルリクエストを同期	a	タスクにサブタスクを追加
Space i	Azure Boards からインポート	S	サブタスクの表示／非表示を切り替え
Space T	テーマを切り替え	y	タスク参照をコピー（[[#12]]）
		w	保留のオン／オフ（クライアント待ち）
Space ?	バグを報告	g g / G	最初／最後のタスク
Esc	閉じる	Delete	タスクを削除

概要画面では、j / k で期限のあるタスク、メンション、プロジェクトを移動し、Enter で開き、a でメンションをタスクとして追加し、x でメンションを閉じます。Space G で現在のプロジェクト用の GitHub リポジトリを作成できます。Ctrl+B で VS Code のようにサイドバーをアイコン表示に折りたたみます。

タスクを開いているときは、[ / ] で前／次の列に移動し、e で編集し、A でサブタスクを追加し、B でブランチを作成し、L で既存のブランチにリンクし、P でプルリクエストを開き、m で別のプロジェクトに移動し、o で独立したウィンドウに切り離し、N で別のタスクのサブタスクにします（または通常のタスクに戻します）。

macOS では、Ctrl ショートカットの代わりに ⌘ を使います。keymap.json で好きなようにキーを再割り当てできます（保存場所はデータを参照してください）。

{
  "leader": "space",
  "bindings": {
    "task.archive": "D",
    "search.open": "<leader>/"
  }
}

アクション ID は ui/src/keymap.ts に記載されています。

コマンドライン

fjord project add "Bokost" --icon '$'
fjord task add bokost "Fix push notifications" -p 3 --due 2026-10-10
fjord column add bokost Review
fjord task move 1 review
fjord task done 1
fjord task nest 3 1                # make #3 a subtask of #1 (unnest to undo)
fjord project show bokost          # board in the terminal
fjord search push
fjord log bokost                   # activity
fjord --json project ls            # JSON for scripts

すべてのオプションについては fjord --help を実行してください。変更はアクター情報とともに記録されます。アクター情報は --actor、$FJORD_ACTOR、または $USER で指定します。

Git と GitHub

Git タブ、または fjord git link <project> <path> を使って、プロジェクトをリポジトリにリンクできます。リポジトリがまだありませんか？プロジェクトの作成時に Also create a repository on GitHub を選択するか、Git タブを使ってください。Fjord は GitHub リポジトリを作成し（非公開または公開、自分のアカウントまたは組織の下に、README、.gitignore、ライセンスを任意で追加できます）、クローンして一度の操作でリンクします。リモートがないローカルリポジトリも、同じ方法で公開できます。GitHub にサインインしていない場合は、その場でサインインできます。

プロジェクトをリンクすると、Fjord は次のことを行います。

• タスク用のブランチを慣例に沿った名前で作成します。例：fix/12-fix-push-notifications。タスクで種別（feat、fix、chore、docs、refactor、test、perf、ci、hotfix）を選ぶか、Fjord に推測させます。バグのようなタスクと Azure のバグには fix を、それ以外には feat を使います。タスクは2番目の列に移動します。
• または、既存のブランチにタスクをリンクします。複数のタスクを同じブランチに関連付けることができ、そのプルリクエストはそれらすべてのタスクに表示されます。
• ブランチ、最近のコミット、CI ステータス付きの GitHub プルリクエストを表示します。
• ブランチ名を使ってプルリクエストをタスクにリンクし、タスクから直接 PR を作成します（タイトルはブランチの種別に従います。例：feat: Add login。説明にはタスクの内容が使われます）。
• Space e で、タスクのブランチを開いた状態でリポジトリをエディターまたは IDE（VS Code、Cursor、JetBrains IDEs、Visual Studio、Zed、Sublime、または独自のコマンド。Settings → Integrations で設定）で開きます。
• Sync 時に PR がマージされると、タスク（またはそのブランチ上のすべてのタスク）を完了に移動します。ただし、自動移動をオフにしている場合を除きます。

GitHub または Azure DevOps からアクセスを拒否された場合、Git タブには、OAuth アプリを制限している組織や SSO 承認が必要な場合など、各サービス独自の説明が表示されます。 Git はインストール済みの git を通じて動作するため、設定、フック、認証情報が適用されます。GitHub へのアクセス（プライベートリポジトリや PR の作成に必要）は、次の順に使用されます。GITHUB_TOKEN/GH_TOKEN、設定の GitHub でサインイン（ブラウザーでのサインイン、OAuth デバイスフロー）、またはそこで貼り付けた個人アクセストークン、あるいは gh auth login。接続されたトークンは GitHub で検証され、OS の認証情報ストア（Windows Credential Manager、macOS Keychain、Linux の Secret Service）に保存されます。Fjord のデータベースやファイルに保存されることはありません。公開リポジトリはトークンなしで読み取れます。

Azure DevOps（ベータ版）。 dev.azure.com（および以前の visualstudio.com URL）上のリポジトリは同じ方法で検出され、同じ機能を利用できます。パイプラインのステータス付きプルリクエスト、タスクごとのブランチ、タスクからの PR 作成、PR の完了時にタスクを完了にする機能です。認証には、AZURE_DEVOPS_EXT_PAT、設定 → Azure DevOps で組織ごとに設定する個人アクセストークン（スコープ：Code Read & Write、Build Read。OS の認証情報ストアに保存）、または Azure CLI を使用します。トークンなしで設定に組織を追加すると、Fjord は az login を使用します。

Azure Boards のインポート（ベータ版）。 自分に割り当てられた作業項目を、選択した Fjord プロジェクトにインポートできます（起動時と 10 分ごと。重複はありません）。各項目は Azure の状態と同じ名前の列に追加されます（Active は進行中の列に、New は最初の列に追加されます）。子項目はサブタスクになり、過去 30 日間に完了した項目（設定で変更可能）も含まれます。また、追加または変更された内容を通知で知らせます。タスクパネルには作業項目のディスカッションが表示されます。AI エージェントは MCP サーバー（import_azure、list_new_imports、mark_analyzed）を通じて新しい項目を分析できます。セットアップ、すぐに使えるトリアージ用プロンプト、スケジュール設定については、docs/azure-boards-triage.md を参照してください。

保留中。 設定 → インテグレーション → 保留中の状態で指定した状態（既定では Pending）の作業項目は、Fjord でも保留中になります。Fjord でインポートしたタスクを保留中にすると、作業項目はその状態に移動し、保留を解除すると元の状態に戻ります。この状態は Azure のプロセス内で作業項目の種類に対して存在している必要があります。また、状態を変更するには作業項目を編集する権限（az login、または Work Items Read & Write の権限を持つトークン）が必要です。Azure が拒否した場合でも、Fjord ではタスクが保留中としてマークされ、その理由が表示されます。保留をローカルのみにするには、この設定を空欄にしてください。

メンション。 自分に割り当てられていない作業項目で誰かに @メンションされると、概要の メンションされた項目に、その項目、自分にメンションした人、相手が書いた内容が表示されます。Azure で開く、プロジェクトにタスクとして追加する、または非表示にできます。新しいメンションも通知されます。これは Azure DevOps の「最近のメンション」機能を使用します（過去 30 日間分。Azure DevOps Services のみ）。

fjord git link bokost ~/code/bokost
fjord git branch 12          # check out (or create) the task's branch
fjord git main bokost        # back to the main branch
fjord git status bokost      # branches and recent commits
fjord git prs bokost         # pull requests + CI; moves merged tasks to done
fjord git pr 12 --draft      # push the branch and open a pull request
fjord git which              # the project and task for the current folder
fjord azure import           # import Azure Boards work items (same settings as the app)
fjord azure links bokost     # the work items behind a project's imported tasks
fjord notes list --folder Work            # notes in a folder and its subfolders
fjord notes move 7 --folder Work/Meetings  # sort a note into a folder
fjord notes rename-folder Work Jobb        # rename a folder and everything under it
fjord notes lock 7 on                      # open read-only in the app

VS Code

Fjord for VS Code を使うと、開いているフォルダーにリンクされたプロジェクトのボードがエクスプローラーに表示され、現在のブランチのタスクがステータスバーに表示されます。

• エディターからタスクを開始（ブランチをチェックアウト）し、移動、完了、またはプルリクエストの作成ができます
• VS Code を離れずに、フォルダーをプロジェクトにリンクし、fjord CLI を検索またはダウンロードできます
• タスク 12 のブランチにいるとき、空のコミットメッセージには #12 が先頭に入力されます
• TODO を右クリックして、該当行にリンクするタスクに変換できます
• アプリを閉じている間も作業項目が取り込まれるよう、Azure Boards のインポートを 10 分ごとに実行します

fjord CLI 0.2.18 以降が必要で、アプリと同じローカルデータベースを使用します。拡張機能のリリースから .vsix をインストールしてください（code --install-extension fjord-*.vsix）。

AI エージェント（MCP）

fjord mcp は stdio 上で Model Context Protocol サーバーを実行します。変更は claude として記録され（--actor で上書きできます）、アプリでは AI タグが表示されます。

Claude Desktop： 最新リリースから fjord-mcp.mcpb をダウンロードして開きます。Claude Desktop は Fjord を拡張機能としてインストールし、コマンドラインツールも同梱します（Apple Silicon 搭載の macOS、Windows、Linux に対応）。Fjord は io.github.jhtjernsmo/fjord として MCP Registry にも登録されています。

その他のクライアントでは、fjord コマンドラインツールを PATH に追加する必要があります（インストールを参照）。Claude Code の場合：

claude mcp add fjord -- fjord mcp

Cursor（~/.cursor/mcp.json）およびその他のクライアントの場合：

{ "mcpServers": { "fjord": { "command": "fjord", "args": ["mcp"] } } }

ツール：list_projects、get_board、create_project、create_task、get_task、update_task、move_task、complete_task、set_task_pending、archive_task、add_note、attach_file、search、recent_activity、link_repo、git_status、start_branch、link_branch、list_pull_requests、open_pull_request、list_notes、get_note、update_note、backlinks、analyze_story、import_azure、list_new_imports、mark_analyzed。意図的に削除ツールは用意していません。

エージェントスキル

MCP ツールでは各ツールの機能を説明し、Fjord スキルではエージェントがそれらを組み合わせて使う方法を説明します。変更を加える前にボードを確認し、説明欄に記載した内容を保ち、作業をタスクに分割し、タスクをブランチからプルリクエストまで進め、ストーリーを分析し、Azure からのインポートをトリアージします。Claude Code と Cursor にインストールしてください（どちらも ~/.claude/skills を読み込みます）。

fjord skill install

fjord skill install --dir .claude/skills を実行すると、代わりにリポジトリ内に配置できます。また、fjord skill を実行すると内容が表示されます。CLI が 0.2.27 より古い場合は、skills/fjord フォルダーを手動で ~/.claude/skills/ にコピーしてください。

データ

	Linux	Windows	macOS
データ（fjord.db、files/）	~/.local/share/fjord	%APPDATA%\fjord	~/Library/Application Support/fjord
キーマップ（keymap.json）	~/.config/fjord	%APPDATA%\fjord	~/Library/Application Support/fjord

アプリの設定には正確なパスが表示されます。別の場所（たとえばテスト用の別データベース）を使うには、FJORD_DATA_DIR / FJORD_CONFIG_DIR を設定してください。データフォルダーをコピーしてバックアップできます。

アーキテクチャ

crates/fjord-core   Rust library: schema & migrations, projects, columns, tasks, files, notes, search, activity
crates/fjord-vcs    Git (via the git CLI), GitHub and Azure DevOps REST integration
crates/fjord-cli    `fjord` CLI and MCP server
src-tauri           Tauri desktop shell — thin commands over fjord-core
ui                  React + TypeScript interface (dnd-kit, Lucide, Motion)

3 つすべてのフロントエンド（GUI、CLI、MCP）は fjord-core を経由するため、検証とアクティビティログはどこでも同じように機能します。

開発

cargo test --workspace             # Rust: core unit tests, CLI and MCP end-to-end tests
npm --prefix ui test               # UI: keymap engine, i18n, helpers (Vitest)
cargo clippy --workspace --all-targets -- -D warnings
cargo fmt --all
npm --prefix ui run typecheck

CONTRIBUTING.md を参照してください。翻訳への貢献を歓迎します。ui/src/i18n.ts の no ブロックをコピーしてください。

ロードマップ

• パッケージ形式の追加：Flathub、AUR、winget
• タグと保存済みフィルター
• 期日のデスクトップ通知
• クリップボードからの画像貼り付け、PDF プレビュー
• Azure Boards へのステータス書き戻し（オプトイン）
• GitHub のイシューとタスクの連携、カード上のレビュー状況
• Windows のコード署名
• タイムラインとカレンダー表示

変更履歴とセキュリティ

各バージョンでの変更点は CHANGELOG.md に記載されています。セキュリティ上の問題は、SECURITY.md に記載された方法で非公開にて報告してください。

ライセンス

お好みに応じて、Apache License 2.0 または MIT のいずれかのライセンスの下で利用できます。