olm

シェルコマンドの実行・解析・履歴管理を行う CLI ツール。 AI（ollama 等）はオプション。なくても RAG ベースで動作する。

---

インストール

./setup.sh
source~/.profile
olm --help

---

使い方

# コマンドを実行して結果を解析
olm "ls -la"# RAG ラッパーで実行（失敗時に過去の類似エラーを検索）
olm -e "git status"# stdin のテキストを解析echo"some log text"| olm --analyze
# 複数コマンドを順に実行printf"%s\n""pwd""ls -la"| olm --exec-stdin --yes
# 履歴
olm history --last 50
# 設定
olm config list
olm config set OLM_LANG jp

---

ディレクトリ構成

olm/
├── README.md
├── DESIGN.md ← 設計書
├── setup.sh
├── bin/
│ └── olm ← エントリポイント
├── lib/
│ ├── common.sh ← 共通関数
│ ├── cmd_analyze.sh ← --analyze
│ ├── cmd_exec.sh ← コマンド実行
│ ├── cmd_history.sh ← history
│ └── cmd_config.sh ← config
├── config/
│ ├── config.env ← デフォルト値
│ └── config.schema.txt ← キー一覧・説明
├── lang/
│ ├── en/
│ │ ├── help.txt
│ │ └── prompt.txt
│ └── jp/
│ ├── help.txt
│ └── prompt.txt
├── ai/
│ ├── ollama.sh ← ollama アダプター
│ ├── openai.sh ← 将来用
│ └── none.sh ← AI なしフォールバック
├── rag/
│ ├── run.sh ← コマンドラッパー
│ ├── store.sh ← DB 操作
│ ├── hint.sh ← コマンドヒント
│ └── rag.db ← SQLite DB
└── completion/
└── engine.sh ← リアルタイム予測変換（実装中）

---

設定

ユーザー設定は ~/.config/olm/config.env に書く。setup.sh が初回作成する。

キー	説明	デフォルト
OLM_LANG	言語（en / jp）	jp
OLM_MODEL_STD	標準モデル	phi3:3.8b-mini-4k-instruct-q4_k_m
OLM_MODEL_LGT	軽量モデル	phi3:3.8b-mini-4k-instruct-q4_k_m
OLM_MODEL_HVY	重量モデル	llama3:8b
OLM_USE_RAG	RAG 有効フラグ	1
OLM_AI_ADAPTER	AI アダプター（ollama/openai/none）	ollama
OLM_ALWAYS_PROMPT	毎回追加するプロンプト	（空）

全キーの説明は config/config.schema.txt を参照。

---

RAG

失敗したコマンドと成功したコマンドを SQLite に蓄積し、類似エラーを検索する。

# DB 初期化（初回のみ）
rag/store.sh init
# 手動でメモを登録
rag/store.sh add "venv忘れ""python,venv""source .venv/bin/activate してから実行"# 検索
rag/store.sh search "permission denied"# RAG ラッパーで実行（失敗時に自動で検索・記録）
rag/run.sh -- python train.py

環境変数（rag/run.sh）

変数	説明	デフォルト
AUTO_SAVE_FAILED	失敗を自動保存	1
DO_RAG_SEARCH	失敗時に RAG 検索	1
HINT_ENABLE	実行前ヒント表示	1
HINT_INTERACTIVE	ヒント選択 UI	auto
LLM_ENABLE	RAG ヒットなし時に LLM 提案	0

---

AI アダプター

OLM_AI_ADAPTER で切り替え。ollama が起動していなくても none で動作する。

# ollama を使う（デフォルト）
olm config set OLM_AI_ADAPTER ollama
# AI を使わない
olm config set OLM_AI_ADAPTER none

---

リアルタイム予測変換（実装中）

入力中のコマンドに対してリアルタイムで候補を表示する。 詳細は DESIGN.md の completion/ セクションを参照。

---

トラブルシュート

Permission denied

chmod +x bin/olm rag/run.sh rag/store.sh rag/hint.sh

rag.db not found

rag/store.sh init

ollama に繋がらない

olm config set OLM_AI_ADAPTER none