Metadata-Version: 2.4
Name: tanren
Version: 0.1.2
Summary: Technical Agent for Nurturing & Reinforcing Engineering Navigation — AI coaching CLI for engineers
Author-email: Shouzou Nozaki <shouzouyeqi66@gmail.com>
License: MIT License
        
        Copyright (c) 2026 Shouzou Nozaki
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
        
Project-URL: Homepage, https://github.com/shouzou-nozaki/tanren
Project-URL: Repository, https://github.com/shouzou-nozaki/tanren
Project-URL: Issues, https://github.com/shouzou-nozaki/tanren/issues
Keywords: cli,coaching,engineer,ai,gemini,productivity
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: typer>=0.12.0
Requires-Dist: rich>=13.0.0
Requires-Dist: google-genai>=1.0.0
Dynamic: license-file

# tanren（鍛錬）

**T**echnical **A**gent for **N**urturing & **R**einforcing **E**ngineering **N**avigation

エンジニア特化のAIコーチCLIです。毎日の作業・学びを記録し、過去の文脈を踏まえてコーチングします。

```
tanren checkin   # 今日の記録
tanren ask "設計力を上げるには？"
tanren skills    # AIによるスキルマップ
tanren review    # 週次振り返り
```

---

## 特徴

- **文脈のあるコーチング** — 過去のチェックイン・目標・スキルを踏まえてAIが回答
- **AIスキル査定** — GitHubリポジトリ＋チェックイン記録から6分野のスキルマップを自動生成
- **毎日の記録** — 作業・学び・詰まったこと・エネルギーを蓄積
- **マルチプロバイダー** — Gemini（無料枠あり）または Claude を選択可能
- **DB自動圧縮** — 古い記録を週次→月次→年次で自動サマリー化

---

## インストール

```bash
pip install tanren
```

---

## セットアップ

```bash
tanren setup
```

- AIプロバイダー選択（Gemini推奨 — [aistudio.google.com](https://aistudio.google.com) で無料取得）
- APIキー入力
- GitHubユーザー名（任意・スキル査定の精度向上）

---

## コマンド一覧

### 毎日の記録

```bash
tanren checkin
```

今日やったこと・学んだこと・詰まったこと・エネルギーレベル（1〜5）を記録します。
チェックイン後、7日以上経過していればスキル査定を自動実行します。

---

### AIコーチに質問

```bash
tanren ask "設計力を上げるには？"
tanren ask   # 引数なしで対話モード
```

過去のチェックイン・目標・スキルを文脈として活用してコーチングします。

---

### スキルマップ

```bash
tanren skills          # 最新の査定結果を表示
tanren skills --assess # 今すぐ再査定
```

チェックイン記録とGitHubリポジトリの言語統計をもとに6分野でスキルを評価します。

| 大分類 | 評価対象の例 |
|--------|------------|
| 実装力 | Python, Java, TypeScript など言語・フレームワーク |
| 設計力 | システム設計, API設計, DB設計 |
| インフラ・運用 | Docker, AWS, Linux, GitHub Actions |
| データベース | PostgreSQL, MySQL, Redis |
| セキュリティ | 認証・認可, 暗号化, 脆弱性対策 |
| ソフトスキル | コードレビュー, 技術共有, ドキュメント作成 |

**レベル基準:**

| Lv | 基準 |
|----|------|
| 1 | 指示があればできる |
| 2 | 一人でできる |
| 3 | 他人に教えられる |
| 4 | 改善・最適化できる |
| 5 | 仕組み化・標準化できる |

---

### 振り返り

```bash
tanren review                  # 週次振り返り
tanren review --period month   # 月次振り返り
```

チェックイン記録をAIが分析し、学びのパターン・課題・次のアクションを提示します。

---

### 成長レポート

```bash
tanren report
```

チェックイン統計・スキルマップ・目標サマリー + AIの総評を表示します。

---

### 目標管理

```bash
tanren goal add          # 目標を追加
tanren goal list         # 一覧表示
tanren goal update <ID>  # 更新
tanren goal delete <ID>  # 削除
```

---

### 過去のやり取りを確認

```bash
tanren history          # 直近10件
tanren history -n 20    # 件数を指定
tanren history --id 3   # ID指定で全文表示
```

---

### 設定変更

```bash
tanren config show              # 現在の設定を表示
tanren config provider          # AIプロバイダーを変更
tanren config model             # モデルを変更
tanren config language          # 応答言語を変更
tanren config github            # GitHubユーザー名を設定
tanren config api-key           # APIキーを更新
```

---

### 予算管理

```bash
tanren budget status     # 今月の使用量を表示
tanren budget set 500    # 月の予算上限を変更（円）
```

---

## データの保存場所

```
~/.tanren/
├── config.json   # APIキー・設定（GitHubにはコミットされません）
└── tanren.db     # 全記録（SQLite）
```

---

## 対応AIプロバイダー

| プロバイダー | 無料枠 | 取得先 |
|---|---|---|
| Google Gemini（推奨） | あり（1日1500リクエスト） | [aistudio.google.com](https://aistudio.google.com) |
| Anthropic Claude | なし（有料） | [console.anthropic.com](https://console.anthropic.com) |
