deprecatedluar/dredge-cargoメモ、設定、キー、ファイルを暗号化して保存するCLIボールト。整理ではなく検索。
> これはパスワードマネージャーではありません。ノートアプリでもありません。そして深海の底生異常標本分類学的原産地登録簿でも絶対にありません。しかし、最初の2つはどちらよりも良くこなします。冗談です（本当に冗談じゃない）。
<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/13610/534f3cc38369a739749d2f98a8e4ec4a1c5df0a0a597aff5295b8cb1e39cc08e.webp" alt="dredge-doge-vs-cheems"/>
[](https://goreportcard.com/report/github.com/DeprecatedLuar/dredge)
[](https://oosmetrics.com/repo/DeprecatedLuar/dredge-cargo)
[](https://go.dev)
<!-- [](https://codecov.io/gh/DeprecatedLuar/dredge-cargo) -->
<div align="center">
[インストール](#install) • [クイックスタート](#quick-start) • [機能](#features) • [リンクコマンド](#link) • [コマンド一覧](#commands) • [仕組み](#how-it-works) • [セキュリティ](#security) • [なぜ作ったか](#why)
</div>
</div>
<div align="center">
整理するな、検索せよ。**_メモ、設定、キー、機密_** — ターミナルから5秒。
</div>
<div align="center">
<a href="https://github.com/DeprecatedLuar/dredge-cargo/stargazers">
<img src="https://img.shields.io/github/stars/DeprecatedLuar/dredge-cargo?style=for-the-badge&logo=github&color=1f6feb&logoColor=white&labelColor=black"/>
</a>
<a href="https://github.com/deprecatedluar/dredge-cargo/blob/main/LICENSE">
<img src="https://img.shields.io/github/license/DeprecatedLuar/dredge-cargo?style=for-the-badge&color=green&labelColor=black"/>
</a>
<a href="https://github.com/DeprecatedLuar/dredge-cargo/releases">
<img src="https://img.shields.io/github/v/release/DeprecatedLuar/dredge-cargo?style=for-the-badge&color=orange&labelColor=black"/>
</a>
</div>
---
> *「ありふれたガラクタで私を煩わせるな。」* — 魚屋
<div align="center">
<!-- demo gif -->
<img src="https://assets.kitploit.com/production/public/readmes/13610/a31d2a13bfbae4b1b41843137d86ddbc2c38b512972389761eab9dfc3ba6023d.gif" alt="dredge デモ" width="800"/>
</div>
```bash
go install github.com/DeprecatedLuar/dredge-cargo/cmd/dredge@latest
```
<div align="right">
[他のインストール方法 ↓](#install)
</div>
---
<h2 id="features"><img height="44" src="https://assets.kitploit.com/production/public/readmes/13610/5e6da8f5d6e3dc6eb114152fb8cc8ee944547f43aa95f2cbb4b7430fde0c08a0.webp"/> あなたがまだ見たことのないクールな機能</h2>
- **暗号化ストレージ** — リポジトリをクローンしても、完全に意味不明の暗号文だけが得られます。パスワードなしではリポジトリに何が入っているかすらわかりません。（AES-256-GCM + Argon2idを使用）
- **インスタント検索** — 独自のファジー検索アルゴリズムを作りました。怠け者なので、300件以上のエントリの中から目的のものをミリ秒で見つけられて、自分で考えなくて済むようにしたかったからです。
- **何でも保存** — メモ、スクリプト、dotfiles、画像、zipアーカイブ。ファイルとして存在するものであれば、何でもdredgeに保存できます。
- **ライブファイルリンク** — クールな機能です。任意のアイテムをシステムパスにシンボリックリンクして、直接またはdredge経由で読み書きできます。変更はリポジトリと双方向に同期されます。
- **Git対応** — あなたが所有するプライベートリポジトリ。`git clone` するだけでデータが手に入ります。
- **セッションパスワード** — ターミナルセッションごとに1回だけプロンプト表示。その後はターミナルを閉じるまでパスワードなしで使用できます。（詳細はセキュリティのセクションをご覧ください）
- **ゴミ箱 + 取り消し** — 削除したアイテムはゴミ箱へ移動します。誤って削除した場合は `dredge undo` で元に戻せます。
---
<h2><img height="32" src="https://assets.kitploit.com/production/public/readmes/13610/21ca061b01116178eca9bbfd0698ebcaf0f63e614165fbc7b904f54508e01836.webp"/> dredgeに何を保存するか？</h2>
あなたを批判するつもりはありません。煩わしいAPIキー（一度しか表示されないもの）、SSH設定、AIプロンプト、パスワード、そのまま実行できるシェルスクリプト、メールテンプレート？、dotfiles（変わってますが問題なく動作します）、zipアーカイブ、映画リスト、クイックアクセス用のURLリスト...
日本語で書かれた『チェンソーマン』第2話の合法的なコピーさえも。（私は特にその話を持っているかもしれません、いや持っていないかもしれません）
---
<h2 id="install"><img height="32" src="https://assets.kitploit.com/production/public/readmes/13610/db2b1ad73c3323b870934910e70cd8249c788b4ffdfaf79b09c75c05c8741937.webp"/> インストール</h2>
 
### Go
```bash
go install github.com/DeprecatedLuar/dredge-cargo/cmd/dredge@latest
```
`$GOPATH/bin`（通常は `~/go/bin`）が `PATH` に含まれていることを確認してください。
### ユニバーサル
```bash
curl -sSL https://raw.githubusercontent.com/DeprecatedLuar/the-satellite/main/satellite.sh | bash -s -- install DeprecatedLuar/dredge-cargo:dredge
```
<details>
<summary>その他のインストール方法</summary>
<br>
**手動インストール**
1. [リリースページ](https://github.com/DeprecatedLuar/dredge-cargo/releases)からお使いのOS向けのバイナリをダウンロード
2. 実行権限を付与: `chmod +x dredge-*`
3. PATHに移動: `mv dredge-* ~/.local/bin/dredge`
---
**ソースからビルド**
```bash
git clone https://github.com/DeprecatedLuar/dredge-cargo
cd dredge-cargo
go build -o dredge ./cmd/dredge
mv dredge ~/.local/bin/
```
</details>
---
<h2 id="quick-start"><img height="32" src="https://assets.kitploit.com/production/public/readmes/13610/b937e031192b68639bfed048d771e9881136e1d0915985740574b930022b2926.webp"/> クイックスタート</h2>
```bash
# 既存のGitリモートで初期化
dredge init yourusername/vault # GitHubの省略記法
# または: dredge init [email protected]:you/vault.git
# 最初のアイテムを追加
dredge add "OpenAI Key" -c "sk-..." -t keys api # -cフラグがない場合はエディタが開きます
# 検索
dredge search openai
# Gitにプッシュ
dredge push
```
<details>
<summary>使用方法</summary>
<br>
```bash
# 何でも追加
dredge add My SSH Config -t ssh dotfiles --import ~/.ssh/config
dredge add "Master Architect Prompt" --import prompt.md -t ai prompts
dredge add "Watchlist" -c "Dune 2, Oppenheimer..." -t lists
dredge add "project-backup" --import project.tar.gz # バイナリファイルもOK :D
# 検索 — 覚えていることを入力するだけ
dredge search prompt
dredge search aws key
dredge search ssh
# 表示、編集、削除
dredge view <id>
dredge edit <id>
dredge rm <id>
dredge undo # 元に戻す
# 検索結果には番号が振られます — 番号を入力して表示
dredge search ssh # 表示: 1. [xKP] SSH Config 2. [mNq] SSH Key
dredge 1 # 直接表示
# Git同期
dredge push
dredge pull
dredge sync # pull + push
```
</details>
---
<h2 id="how-it-works"><img height="32" src="https://assets.kitploit.com/production/public/readmes/13610/479f1ebf816d929f37e78e3a97679f47640eb18c52a9f1c129745bdffb7df1be.webp"/> 仕組み</h2>
> *「深淵に何が潜んでいるのか想像もつかない。」* — 灯台守
では、まとめます：
使用する主要な暗号技術は2つ、Argon2idともちろんAES-256、特にGCMバリアントです。
Argon2idは、RFC 9106の推奨であり、2015年PHCの勝者だからです。以上です。
AESのGCMバリアントは、暗号化データすべてに改ざんを不可能にするフィンガープリントを付与するからです。以上です。
現在、すべてのデータは `~/.local/share/dredge/` に暗号化ファイルとして保存されています。このディレクトリはGitリポジトリでもあります（少なくとも現時点では）。そのため、`dredge push` でコミットしてプッシュすると、バックアップとしてすべてが保存されます。各アイテムは、ランダムな3文字のIDを持つ独立した暗号化ブロブです。ファイル名が漏れないようにしたため、誰かがデータを見ても何を見ているのかわかりません。
### 暗号化パイプライン
```
あなたのパスワード
+ 16バイトのランダムソルト ← ソルトは .dredge-key に保存されます
→ Argon2id (64 MB メモリ · 4 スレッド · 1 イテレーション)
→ 32バイトのマスターキー (ソルト + パスワード = 実際のキー)
マスターキー + アイテムコンテンツ (TOML: タイトル、タグ、コンテンツ)
→ AES-256-GCM、操作ごとに新たなランダム12バイトのnonceを使用
→ [12B nonce][暗号文 + 16B 認証タグ]
→ items/xKP としてディスクに書き込まれる (ランダムID、拡張子なし)
```
したがって、ボールト全体で同じ派生キーが共有されます（つまり、キーを失うとデータを失います。キーを失わないでください）。すべてのアイテムは同じキーを使用し、それぞれに独自のランダムnonceがあります。同じコンテンツを2回暗号化すると、まったく異なる暗号文が生成されます。
### 保存場所
```
~/.local/share/dredge/ ← ボールト (Gitリポジトリ)
├── .git/
├── .gitignore ← .spawned/ と links.json を除外
├── .dredge-key ← ソルト + 暗号化された検証文字列
├── items/
│ ├── xKP ← 暗号化されたアイテム
│ ├── mNq ← 暗号化されたアイテム
│ └── ...
├── .spawned/ ← リンクされたアイテムの平文コピー
└── links.json ← シンボリックリンクマニフェスト
```
すべての暗号化ファイルと `.dredge-key` はGitリポジトリに保存されます。平文ファイル（システムから読み取り可能にしたいと決めたもの）は追跡されません。好きなように扱ってください。
### セッションモデル
ターミナルで最初のコマンドを実行すると、派生した32バイトのキーが `$XDG_RUNTIME_DIR/dredge/$PPID/.key` にキャッシュされます（ルートのみアクセス可能）
**同じ**ターミナル内での以降のすべてのdredgeコマンドは、キャッシュされたキーを使用します。つまり、パスワードのプロンプトは表示されなくなります。各ターミナルは、親PIDに基づいた独立したディレクトリを取得します。そのため、ターミナルが死ぬとキーはディスクから消えます。
<details>
<summary>より詳細な技術情報</summary>
<br>
**鍵導出 — Argon2id:** RFC 9106推奨パラメータ (64 MB メモリ、4 スレッド、1 イテレーション)。`.dredge-key` 内のソルトは秘密である必要はありません。ファイルがあってもパスワードのブルートフォースを非常に高コストにするだけです。あなたのパスワードが安全を守るので、何をすべきかはおわかりでしょう。
**暗号 — AES-256-GCM:** すべての暗号化にフィンガープリントを付けます。機密性と完全性の両方を提供します。暗号文を改ざんしても、復号化はガベージを生成せず、復号化に失敗してエラーを出力します。
**パスワード検証:** `.dredge-key` には、マスターキーで暗号化された文字列 `dredge-vault-v1` が含まれています。新しいセッションごとに、dredgeはこれを復号化してパスワードが正しいかどうかを検証します。そのため、`dredge-vault-v1` が得られなければパスワードは間違っており、操作の途中で間違ったパスワードに気付くのではなく、約100msで失敗します。
**キャッシュされるもの:** セッションファイルは、派生した32バイトのキー（パスワード + ソルト）を保存します。パスワード自体は保存しません（そこまで愚かではありません）。そのため、アクティブなセッション中に誰かが `.key` を読んでも、パスワードを回復することはできません。
</details>
---
<h2 id="security"><img height="56" src="https://assets.kitploit.com/production/public/readmes/13610/8dd63d36b5812744ccd584320794a580b7e1ee13ac9d33a1af0fa8ef8e364381.webp"/> セキュリティ</h2>
> *「小さな漁獲でも帰れる方が、まったく帰れないよりはましだ。」* — 魚屋
### 脅威モデル（このセクションはAIで作成しましたが、正しい内容です）
**誰かがあなたのプライベートGitリポジトリをクローンした場合：**
暗号化されたブロブと `.dredge-key` を入手します。ソルトは秘密ではありません。その目的は事前計算攻撃を非現実的にすることです。パスワードがなければ、アイテムは不透明なバイナリデータです。Argon2idはオフラインでのブルートフォースを高コストにします。強力なパスワードを使用してください。
**誰かが実行中のあなたのセッションにアクセスした場合：**
派生キーは、そのターミナルセッションの間、`$XDG_RUNTIME_DIR/dredge/$PPID/.key` に存在します。各ターミナルは独立したディレクトリを取得します。ターミナルを閉じればキーは消えます。そのパスはユーザースコープ（モード700）であり、RAMバックアップです。セッションディレクトリへの読み取りアクセスを持つ攻撃者は、ボールトを復号化できます。ホームディレクトリにある機密の認証情報と同じように扱ってください。誰かがあなたのマシンでroot権限を持っているなら、dredgeキーはあなたの心配事の中で最も小さなものです。
**誰かがオフラインのマシンに物理的にアクセスした場合：**
ディスク上のアイテムは暗号化されています。セッションキーはRAMバックアップストレージにあり、再起動後は保持されません。リンクされたアイテム（`.spawned/`）はディスク上に平文で存在します — 以下を参照。
### 平文が存在する場所
| 場所 | いつ | ライフタイム |
|----------|------|---------|
| RAMのみ | 表示、検索、編集のたび | コマンド終了時に解放 |
| `$XDG_RUNTIME_DIR/dredge/$PPID/edit-*.txt` | `dredge edit` 実行中のみ | エディタ終了後に削除 |
| `~/.local/share/dredge/.spawned/<id>` | `dredge link` 実行後 | `dredge unlink` を実行するまで |
スパウンファイルはディスク上に残る唯一の永続的な平文であり、アイテムをシステムパスに明示的にリンクしたためにのみ存在します。その他はすべてメモリ内のみです。
### 注意点
- **`--password` / `DREDGE_PASSWORD`:** パスワードをインラインで渡すと、シェル履歴や `ps` の出力に露出します。環境変数は子プロセスに漏洩する可能性があります。共有環境では両方を避けてください。
- **`--vault` / `DREDGE_VAULT`:** 変更を永続化せずに、単一コマンドでアクティブなボールトを上書きします。複数のボールトを使用したスクリプティングに便利です。
- **リンクされたアイテム:** リンクされたアイテムの平文は、シンボリックリンク先（例：`~/.ssh/config`）に存在します。Gitで追跡されませんが、ディスク上に平文で存在します。
<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/13610/dcc75e764202f8315a3a56114ee19e79a70acd9dcc1094f70031f022e18ad76d.webp" width="700"/>
</div>
<h2 id="link"><img height="32" src="https://assets.kitploit.com/production/public/readmes/13610/ca14a510c662e4e6a349bbc44aa1eb397d2ded5d06ba7bd7f21f2cca50a0c1bd.webp"/> リンクコマンド</h2>
保存されたアイテムをファイルシステム上のパスにリンクします：
```bash
dredge link <id> ~/.ssh/config
```
このコマンドは、`~/.ssh/config` にシンボリックリンクを作成し、dredgeが管理する平文コピーを指し示します（ファイルはディスクに露出するため、使用可能になります）。ファイルを直接編集するか、`dredge edit` などを使用するか、好きな方法で編集でき、すべての変更は自動的に暗号化ストアに同期されます。
**自動修復:** シンボリックリンクの名前を変更した場合（例：`mv ~/.ssh/config ~/.ssh/config-backup`）、dredgeは新しいパスを自動的に検出して追跡します。削除されたシンボリックリンクはセッション開始時にクリーンアップされます。
<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/13610/474132cd19d95d478c40ab360838423dcfcef2033d09f230a8640051dcd08d8e.gif" alt="dredge リンクデモ" width="800"/>
</div>
新しいマシンでの操作：
```bash
git clone [email protected]:you/vault.git ~/.local/share/dredge
dredge link <id> ~/.ssh/config
# 同じSSH設定、同じキー、すべてのマシンでGitが更新を追跡
```
これこそが、dredgeを作った**本当の**理由です。私のSSH設定はすべてのマシンで同一ですが、dotfilesの中にただ放り込むわけにはいきませんでした。
---
<h2 id="commands"><img height="32" src="https://assets.kitploit.com/production/public/readmes/13610/8c572a94c96ee031536884f6f6d32202d53ca05943b0b1083ed05b86fad3641a.webp"/> 全コマンド一覧</h2>
<div align="left">
| コマンド | 説明 | 例 |
|:--------|:------------|:--------|
| `add` / `a` / `new` / `+` | アイテムを追加（-cフラグがない場合はエディタが開く） | `dredge add "OpenAI Key" -c "sk-..." -t keys` |
| `search` / `s` | アイテムを検索 | `dredge search aws key` |
| `list` / `ls` | 全アイテムを一覧表示 | `dredge ls` |
| `view` / `v` | アイテムを表示 | `dredge view xKP` または `dredge 1` |
| `cat` / `c` | 生のコンテンツを出力（パイプ用） | `dredge cat xKP \| bash` |
| `edit` / `e` | アイテムを編集 | `dredge edit xKP` |
| `rm` | 削除（ゴミ箱に移動） | `dredge rm 1 2 3` |
| `undo` | 最後に削除したアイテムを復元 | `dredge undo` |
| `link` / `ln` | アイテムをシステムパスにリンク | `dredge link xKP ~/.ssh/config` |
| `unlink` | リンクを削除 | `dredge unlink xKP` |
| `mv` / `rename` | アイテムIDの名前変更 | `dredge mv xKP abc` |
| `export` | ファイルアイテムをディスクにエクスポート | `dredge export xKP ./output/` |
| `copy` / `cp` | アイテムの内容をクリップボードにコピー | `dredge copy xKP` |
| `lock` | ボールトをロック（セッションキーをクリア） | `dredge lock` |
| `init` / `use` | ボールトを初期化またはアクティブ化 | `dredge init ~/vaults/work` |
| `push` / `pull` / `sync` | Git同期（変更を自動コミット） | `dredge sync` |
| `drop` | コミットされていない変更を破棄 | `dredge drop xKP` または `dredge drop --all` |
| `status` | 保留中の変更を表示 | `dredge status` |
| `passwd` | ボールトのパスワードを変更 | `dredge passwd` |
| `update` | 最新バージョンに更新 | `dredge update` |
</div>
### Git同期（wlad031 作）
Git同期はプレーンな `git` を使用し、任意のリモートで動作します（GitHub/GitLab/Gitea など）。
`dredge init` はオプションのGitリモートを受け入れます。省略した場合、dredgeはローカルのみのGitリポジトリを初期化します（リモートなし）。
**自動コミット動作:** `push`、`pull`、`sync` は、リモートと調整する前に、同期されていない未コミットの変更をコミットで保存します。リモートバージョンを優先するためにローカルの変更を破棄する必要がある場合は、`dredge drop` を使用してください。
**自動履歴保持:** `push` と `sync` は `dredge.toml` のポリシーを適用します。アイテムのメタデータとバイナリストレージは、アイテムごとのバージョン数と暗号化バイト数の独立した制限を持ち、`history.deleted.retain_for` は削除されたIDが復元可能な期間を制御します。ポリシーが何も削除しない場合、Dredgeは通常のプッシュを行います。圧縮が必要な場合、Dredgeは置換履歴を検証し、正確な force-with-lease を使用します。同時のリモート更新は上書きされずに安全に停止します。`pull` は圧縮や force-push を行いません。
保持された履歴は `dredge history`、`dredge history deleted`、または `dredge history <id>` で確認できます。削除された暗号化アイテムは `dredge history restore <id>` で復元できます。パスワード変更は履歴ブロブを再暗号化しないため、古いパスワードで作成された復元バージョンは現在のパスワードでは復号化できない可能性があります。
受け入れられるリモート形式：
```bash
# GitHubの省略記法（https://github.com/<owner>/<repo>.git に展開）
dredge init owner/repo
# HTTPS
dredge init https://github.com/owner/repo.git
dredge init https://gitlab.com/group/repo.git
# SSH（scp形式）
dredge init [email protected]:owner/repo.git
dredge init [email protected]:group/repo.git
# SSH URL
dredge init ssh://[email protected]/owner/repo.git
# ローカルパスリモート（上級者向け）
dredge init /srv/git/dredge-vault.git
```
- Dredgeはリモートリポジトリを自動で作成しません。
- `origin` が設定されていない場合、`dredge push`/`pull`/`sync` はガイダンス付きでエラーになります。
- すでにGitリモートが設定されている場合、`dredge init` は上書きしません。
---
<h2 id="why"><img height="32" src="https://assets.kitploit.com/production/public/readmes/13610/b68b7786d5870a11a1d49137213cb61e51a25165c205d3a99298d7a27a616242.webp"/> なぜ作ったか</h2>
<img src="https://assets.kitploit.com/production/public/readmes/13610/23c3be123dc3423443be52804789e0647f1aaa477647cc9945dad19e4fe789a2.webp" alt="dredge ロゴ" align="right" width="200"/>
> *「私は収集家だ — 多くのものの：芸術と工芸品、宝物と真実…そして欲望の周辺に位置する好奇心。」* — コレクター
何かを保存したものの、必要なときにどこにあるかわからないという精神的負荷。
重要なもの（そして重要でないものも、単に全般的なもの）があちこちに散らばっていることにうんざりしていました。6年前に作ったメールアカウントにアクセスしなければならなかったのは、理由もなく緊急にアクセスする必要があったランダムなサービスにリンクされていたからです…とにかく、多くのツールにはそれぞれの特徴があるものの、情報を保存するという非常に重要な側面で重複していることに気づき、その**特定の**重複に特化し、各ツールが最も得意とすることを任せるツールを作りました。
私は怠け者なので、ただ動作し、私の心を読み、エントリの追加やナレッジベースからの取得に労力を要さないものが欲しかったのです。
かつて [jrnl](https://jrnl.sh) をダウンロードし、そのアイデアはとても気に入りましたが、奇妙なパラメータのせいで実行には満足できませんでした。アイテムの分離がなく、*すべて*にマッチする検索でした。Dredgeは私が実際に欲しかったものです。（つまり、ほぼ個人的なツールです）
<div align="center">
<img src="https://assets.kitploit.com/production/public/readmes/13610/90f2f36bb0ca104704eb98c1ad2711f7c53b008a66ddfc4334e4503986e515b7.webp" width="600"/>
</div>
---
<h2><img height="32" src="https://assets.kitploit.com/production/public/readmes/13610/dee19080cbb4c8dc2511711c86f32617b12ee55e34ffc08658215533f7420640.webp"/> コントリビューター</h2>
dredgeに貢献してくれた皆さん、本当にありがとう：
<table>
<tr>
<td align="center">
<a href="https://github.com/timcondit"><img src="https://assets.kitploit.com/production/public/readmes/13610/5c0d0e21e68f12b1687cb275ffdfa6b84b6b825998061fb623d88640fcd20f10.jpg" width="48" /><br/>timcondit</a>
</td>
<td align="center">
<a href="https://github.com/wlad031"><img src="https://assets.kitploit.com/production/public/readmes/13610/84d9b6594e04f211f09cbf1b128c591c80ac702807a91a75a5973a4bd384c238.jpg" width="48" /><br/>wlad031</a>
</td>
</tr>
</table>
---
<div align="center">
Made with <img src="https://assets.kitploit.com/production/public/readmes/13610/1838297af83d5d3f60028a5f542ff33ccac6b76e0ebe57671a9d9e9f40ec40a1.webp" height="200" style="vertical-align:middle"/> by Luar
</div>