kinako

安価な LLM（OpenRouter 経由の Qwen / DeepSeek 等）で動く、ターミナルのアシスタント。 Claude Code とは別ターミナルで気軽に使い、トークン消費を節約するための小さな道具。 中立・冷静で、出力は枠も色もないプレーンテキスト（DOSプロンプト風）なので、そのままコピペできます。

• 雑談・ちょっとした質問・相談相手
• カレントディレクトリ(cwd)内のファイル/フォルダを読む・要約・検索（docs/ 等のサブフォルダ含む）
• コードを書く・直す・レビューする
• 明示的に頼んだ時だけ cwd 内にファイルを作成/保存（.py など任意拡張子可）
• コードの実行はしない（安全のため）。実行はユーザー自身が別ターミナルで。

会話は cwd の YYYY-MM-DD.log（日次）に自動で記録されます。

使い方

kinako                  # 対話ループを起動（`> ` で入力／`/exit` か Ctrl+D で終了）
kinako --ask "git rebaseって何？"   # ワンショット（1往復だけ）
kinako --cwd ~/proj     # 作業ディレクトリを指定

会話例：

> docs/ のファイル、要点まとめて memo.md に保存して
●kinako docs/ の3ファイルを読みました。要点をまとめて memo.md に保存しました（28行）。
        - 保存しました: memo.md

安全設計（三重ガード）

1. cwd の外に出られない（読み書きともパス閉じ込め）
2. コードを実行できない（run 系ツールを一切持たない）
3. 指示した時だけ書く（普段の会話ではファイルを作らない／既存ファイルは上書き前に確認）

インストール

pipx install -e .        # ローカル開発導入（このディレクトリで）
# もしくは
uv tool install -e .

設定と APIキー

• APIキー：環境変数 OPENROUTER_API_KEY、または ~/.config/kinako/.env。 リポジトリ直下に .env.sample を同梱しているのでコピーして使えます (cp .env.sample .env → 値を埋める)。
• モデル変更：~/.config/kinako/config.toml で [model] model = "..." の1行を上書き。 既定は qwen/qwen3-coder-plus。雑談重視なら qwen/qwen3-235b-a22b-2507、 さらに安く deepseek/deepseek-chat 等。
• 読んだファイル内容・会話は外部 LLM（OpenRouter）へ送信されます。機密の取扱いは利用者が判断してください。

開発

python3 -m venv .venv && .venv/bin/pip install -e ".[dev]"
.venv/bin/pytest -q
.venv/bin/kinako --ask "こんにちは"