agent-roi-tracker 0.1.0__tar.gz

agent_roi_tracker-0.1.0/.claude/settings.local.json

@@ -0,0 +1,8 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(rm -f dist/*)",
+      "Bash(uv build *)"
+    ]
+  }
+}

agent_roi_tracker-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,24 @@
+---
+name: Bug report
+about: Report a problem with Agent-ROI
+title: "[Bug] "
+labels: bug
+---
+
+**Describe the bug**
+A clear description of what went wrong.
+
+**To reproduce**
+Steps to reproduce the behavior (commands run, config used).
+
+**Expected behavior**
+What you expected to happen.
+
+**Environment**
+- OS: [e.g. macOS 14 / Windows 11 / Ubuntu 22.04 / WSL2]
+- Python version: [`python --version`]
+- Agent-ROI version: [`agent-roi --version` or commit]
+- AI tools tracked: [e.g. Claude Code, Codex]
+
+**Logs / output**
+Paste any relevant error output (redact anything sensitive).

agent_roi_tracker-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,18 @@
+---
+name: Feature request
+about: Suggest an idea or a new tool integration
+title: "[Feature] "
+labels: enhancement
+---
+
+**Problem**
+What problem does this solve? Which AI tool or workflow is involved?
+
+**Proposed solution**
+What would you like to happen?
+
+**Alternatives considered**
+Any alternative approaches you've thought about.
+
+**Additional context**
+Anything else (links, screenshots, log formats for a new collector).

agent_roi_tracker-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,14 @@
+## Summary
+
+<!-- What does this PR do and why? -->
+
+## Changes
+
+<!-- Bullet list of notable changes -->
+
+## Checklist
+
+- [ ] Tests added/updated and `uv run pytest` passes
+- [ ] `uv run ruff check src tests` passes
+- [ ] `uv run mypy` passes
+- [ ] Docs updated (both `*.md` and `*.zh.md` where applicable)

agent_roi_tracker-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,52 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+
+jobs:
+  backend:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        os: [ubuntu-latest, macos-latest, windows-latest]
+        python-version: ["3.10", "3.12"]
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+        with:
+          enable-cache: true
+
+      - name: Set up Python ${{ matrix.python-version }}
+        run: uv python install ${{ matrix.python-version }}
+
+      - name: Install dependencies
+        run: uv sync --extra dev
+
+      - name: Lint
+        run: uv run ruff check src tests
+
+      - name: Type check
+        run: uv run mypy
+
+      - name: Test
+        run: uv run pytest --cov=agent_roi --cov-report=term-missing
+
+  frontend:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: web
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: "22"
+          cache: npm
+          cache-dependency-path: web/package-lock.json
+      - run: npm ci
+      - run: npm run build

agent_roi_tracker-0.1.0/.gitignore

@@ -0,0 +1,30 @@
+# Python
+__pycache__/
+*.py[cod]
+.venv/
+*.egg-info/
+.pytest_cache/
+.mypy_cache/
+.ruff_cache/
+.coverage
+htmlcov/
+dist/
+build/
+
+# Node / web
+web/node_modules/
+web/dist/
+web/*.tsbuildinfo
+*.log
+
+# Web UI bundled into the package at build time
+src/agent_roi/webui/
+
+# Local data & config
+*.db
+.env
+
+# Editors / OS
+.DS_Store
+.idea/
+.vscode/

agent_roi_tracker-0.1.0/CLAUDE.md

@@ -0,0 +1,84 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
+
+## Commands
+
+Backend (Python, managed with `uv`):
+
+```bash
+uv sync --extra dev          # install deps incl. dev tools
+uv run pytest                # run the full test suite
+uv run pytest tests/test_semantic_classifier.py            # single file
+uv run pytest tests/test_sessions.py::test_name -x         # single test
+uv run ruff check src tests  # lint
+uv run mypy                  # type-check (strict; checks src/ only)
+```
+
+Frontend (React + Vite, in `web/`, managed with npm):
+
+```bash
+cd web
+npm install
+npm run dev      # Vite dev server on :5173 (CORS-allowed by the API)
+npm run build    # tsc -b && vite build
+```
+
+Run the app locally:
+
+```bash
+uv run agent-roi ingest      # collect logs from enabled tools, then classify
+uv run agent-roi report --by tool --since 7d
+uv run agent-roi serve       # FastAPI on :8000 (serves built web UI if present)
+uv run agent-roi doctor      # which tools were detected, where, and what was found
+```
+
+During UI dev run `agent-roi serve` (API on :8000) and `npm run dev` (UI on :5173) together; the API allows the Vite origin via CORS.
+
+## Release builds
+
+The web UI is bundled into the Python package so `agent-roi serve` works after a plain install. The bundle lives at `src/agent_roi/webui/` — it is **gitignored** but listed as a hatch build artifact, so it must be regenerated before building a wheel:
+
+```bash
+./scripts/build_web.sh    # npm ci + build, then copy web/dist -> src/agent_roi/webui
+uv build                  # wheel/sdist (includes the web UI)
+```
+
+## Architecture
+
+A local-first pipeline that turns the session logs AI coding tools already write into a per-topic view of token cost. Data never leaves the machine; everything is in one SQLite file.
+
+```
+Collectors ──▶ Storage ──▶ Classifier ──▶ Storage ──▶ Reports (CLI / API / Web)
+ (parse logs)   (SQLite)    (semantic)     (topics)
+```
+
+`core/service.py` (`Service`) is the single orchestration point wiring collectors → storage → classifier. **Both the CLI (`cli/main.py`, Typer) and the REST API (`api/app.py`, FastAPI) are thin layers over `Service`** — put logic in `Service`, not in either entry point. The API serves the built web UI as static files when present.
+
+### Pipeline stages
+
+1. **Collectors** (`collectors/`) — one `Collector` subclass per tool (Claude Code, Codex, Copilot, Gemini CLI). They parse local logs into normalized `Interaction` objects and are **read-only and idempotent**: each `Interaction.id` is stable, so re-running `ingest` upserts rather than double-counts. Collectors expose `is_available()`, `collect()`, plus diagnostics hooks (`search_paths()`, `count_files()`, `note()`) surfaced by `doctor`.
+
+2. **Storage** (`storage/db.py`, `Database`) — SQLite via SQLAlchemy. Upserts interactions, computes per-interaction USD cost at write time from the pricing table, and does all aggregation (`rollup`, `topic_breakdown`, `sessions`, `session_detail`). Topic labels are stored on rows and cleared/rebuilt by classify.
+
+3. **Classifier** (`classify/`) — **model-free, offline only**. The single provider is `semantic` (`classify/semantic.py`): TF-IDF + cosine-similarity clustering, no model weights, no API keys, no network. It classifies **whole sessions as a unit** (a session = one continuous piece of work) and applies the discovered topic to all of that session's rows, so cost can be aggregated *per subject* rather than per request. `classify()` defaults to `reclassify=True`, which wipes and rebuilds all topics to keep clustering globally consistent.
+
+4. **Reports** — `Service.report(dimension=...)` aggregates by `topic | tool | model | project`, optionally time-windowed (`parse_since` accepts dates or shorthand like `7d`, `24h`, `today`). Drill into a topic with `topic_breakdown` (split by tool and model). Estimated token counts (tools that don't report usage) are badged distinctly from exact ones throughout CLI/API/UI.
+
+### Core domain (`core/`)
+
+`models.py` defines the canonical types — `Interaction` (the unit), `Rollup`, `TopicBreakdown`, `SessionSummary/Detail`, `CollectorStatus`. `pricing.py` is the per-model price table (USD per 1M tokens) behind every cost figure; surfaced verbatim by `agent-roi pricing` for trust. `platform.py` handles cross-platform log discovery (Windows/macOS/Linux + WSL where tools run on the Windows side) — use `find_tool_dirs(...)` from collectors. `config.py` loads `~/.config/agent-roi/config.toml` (override via `AGENT_ROI_CONFIG`); all fields have defaults so the tool works with zero config.
+
+## Adding a collector
+
+1. Create `collectors/<tool>.py` subclassing `Collector`; set `tool` and `name`.
+2. Implement `is_available()` and `collect()`; use `core.platform.find_tool_dirs(...)` for log discovery so all platforms work.
+3. Register it in `collectors/__init__.py` (and the default `collectors.enabled` list in `core/config.py` if it should be on by default).
+
+See `docs/collectors.md` for the full guide.
+
+## Conventions
+
+- The frontend follows the design system in `design/DESIGN.md`; its tokens are mirrored as CSS variables in `web/src/index.css`. Read it before changing UI styles.
+- Docs are bilingual: every `docs/*.md` (and `README.md`, `CONTRIBUTING.md`) has a `*.zh.md` translation — update both when changing docs.
+- Python is `strict` mypy and ruff-linted (`E,F,I,UP,B,SIM`, line length 100).

agent_roi_tracker-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,37 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, religion, or sexual identity and
+orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment:
+
+- Demonstrating empathy and kindness toward other people
+- Being respectful of differing opinions, viewpoints, and experiences
+- Giving and gracefully accepting constructive feedback
+- Accepting responsibility and apologizing to those affected by our mistakes
+
+Examples of unacceptable behavior:
+
+- The use of sexualized language or imagery, and sexual attention or advances
+- Trolling, insulting or derogatory comments, and personal or political attacks
+- Public or private harassment
+- Publishing others' private information without explicit permission
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the project maintainers. All complaints will be reviewed and
+investigated promptly and fairly.
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1.
+
+[homepage]: https://www.contributor-covenant.org

agent_roi_tracker-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,78 @@
+# Contributing to Agent-ROI
+
+Thanks for your interest in improving Agent-ROI! This guide gets you set up and
+explains how we work.
+
+> 繁體中文版：[CONTRIBUTING.zh.md](./CONTRIBUTING.zh.md)
+
+## Development setup
+
+Agent-ROI has a Python backend (managed with [uv](https://docs.astral.sh/uv/))
+and a React frontend (managed with npm).
+
+```bash
+# Backend
+uv sync --extra dev
+uv run pytest          # run tests
+uv run ruff check src  # lint
+uv run mypy            # type-check
+
+# Frontend
+cd web
+npm install
+npm run build
+```
+
+## Project layout
+
+```
+src/agent_roi/
+  collectors/   # parse each tool's local logs -> Interaction
+  classify/     # model-free semantic topic discovery (TF-IDF + cosine clustering)
+  storage/      # SQLite persistence + aggregation
+  core/         # domain models, config, pricing, platform, service
+  api/          # FastAPI REST layer
+  cli/          # Typer command-line interface
+web/            # React + Vite dashboard
+design/         # DESIGN.md design system (Linear) — read before UI changes
+docs/           # English docs (*.md) + Chinese translations (*.zh.md)
+tests/          # pytest suite
+```
+
+The frontend follows the design system in [`design/DESIGN.md`](./design/DESIGN.md)
+(Notion). Its tokens are mirrored as CSS variables in `web/src/index.css`; read
+it before changing UI styles so the look stays consistent.
+
+### Building a release
+
+The web UI is bundled into the Python package so `agent-roi serve` works after a
+plain install. Before building a wheel:
+
+```bash
+./scripts/build_web.sh   # builds web/ and copies it into src/agent_roi/webui
+uv build                 # produces the wheel/sdist (includes the web UI)
+```
+
+## Adding a collector
+
+A new tool integration is just a `Collector` subclass:
+
+1. Create `src/agent_roi/collectors/<tool>.py` subclassing `Collector`.
+2. Implement `is_available()` and `collect()` (see existing collectors).
+3. Use `core.platform.find_tool_dirs(...)` to locate logs so Windows/macOS/Linux
+   and WSL all work.
+4. Register it in `collectors/__init__.py`.
+5. Add a fixture-based test under `tests/`.
+
+See [docs/collectors.md](./docs/collectors.md) for the full guide.
+
+## Pull requests
+
+- Keep PRs focused; one logical change per PR.
+- Add or update tests for behavior changes.
+- Run `uv run ruff check src tests` and `uv run pytest` before pushing.
+- Update both the English doc and its `.zh.md` translation when changing docs.
+
+## Code of Conduct
+
+By participating you agree to our [Code of Conduct](./CODE_OF_CONDUCT.md).

agent_roi_tracker-0.1.0/CONTRIBUTING.zh.md

@@ -0,0 +1,75 @@
+# 貢獻 Agent-ROI
+
+感謝你有興趣改善 Agent-ROI！本指南帶你完成環境設定，並說明我們的協作方式。
+
+> English version: [CONTRIBUTING.md](./CONTRIBUTING.md)
+
+## 開發環境設定
+
+Agent-ROI 有一個 Python 後端（以 [uv](https://docs.astral.sh/uv/) 管理）與一個
+React 前端（以 npm 管理）。
+
+```bash
+# 後端
+uv sync --extra dev
+uv run pytest          # 跑測試
+uv run ruff check src  # lint
+uv run mypy            # 型別檢查
+
+# 前端
+cd web
+npm install
+npm run build
+```
+
+## 專案結構
+
+```
+src/agent_roi/
+  collectors/   # 解析各工具的本地 log -> Interaction
+  classify/     # 免模型的語意主題歸納（TF-IDF + 餘弦相似度分群）
+  storage/      # SQLite 持久化 + 彙總
+  core/         # 領域模型、設定、定價、平台、服務
+  api/          # FastAPI REST 層
+  cli/          # Typer 命令列介面
+web/            # React + Vite 儀表板
+design/         # DESIGN.md 設計系統（Linear）— 改 UI 前請先閱讀
+docs/           # 英文文件 (*.md) + 中文翻譯 (*.zh.md)
+tests/          # pytest 測試
+```
+
+前端遵循 [`design/DESIGN.md`](./design/DESIGN.md)（Notion）的設計系統。其 token 已
+鏡射為 `web/src/index.css` 的 CSS 變數；改動 UI 樣式前請先閱讀，讓外觀維持一致。
+
+### 建置發佈版本
+
+web UI 會被打包進 Python 套件，讓一般安裝後 `agent-roi serve` 也能運作。建置 wheel 前：
+
+```bash
+./scripts/build_web.sh   # 建置 web/ 並複製進 src/agent_roi/webui
+uv build                 # 產生 wheel/sdist（含 web UI）
+```
+
+## 新增採集器
+
+新的工具整合就是一個 `Collector` 子類：
+
+1. 建立 `src/agent_roi/collectors/<tool>.py`，繼承 `Collector`。
+2. 實作 `is_available()` 與 `collect()`（參考既有採集器）。
+3. 使用 `core.platform.find_tool_dirs(...)` 定位 log，讓 Windows/macOS/Linux 與
+   WSL 都能運作。
+4. 在 `collectors/__init__.py` 中註冊。
+5. 在 `tests/` 下新增以 fixture 為基礎的測試。
+
+完整指南見 [docs/collectors.zh.md](./docs/collectors.zh.md)。
+
+## Pull Request
+
+- 保持 PR 聚焦；一個 PR 一個邏輯變更。
+- 行為變更請新增或更新測試。
+- push 前請執行 `uv run ruff check src tests` 與 `uv run pytest`。
+- 變更文件時，請同時更新英文文件與其 `.zh.md` 翻譯。
+
+## 行為準則
+
+參與本專案即表示你同意我們的[行為準則](./CODE_OF_CONDUCT.md)。

agent_roi_tracker-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent-ROI contributors
+
+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.

agent_roi_tracker-0.1.0/PKG-INFO

@@ -0,0 +1,163 @@
+Metadata-Version: 2.4
+Name: agent-roi-tracker
+Version: 0.1.0
+Summary: Track the cost, usage, and ROI of your AI coding agents across every tool.
+Project-URL: Homepage, https://github.com/Agent-ROI/agent-roi
+Project-URL: Repository, https://github.com/Agent-ROI/agent-roi
+Project-URL: Issues, https://github.com/Agent-ROI/agent-roi/issues
+Author: Agent-ROI contributors
+License: MIT
+License-File: LICENSE
+Keywords: ai,claude,codex,cost,llm,observability,roi,tokens
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: fastapi>=0.111
+Requires-Dist: httpx>=0.27
+Requires-Dist: platformdirs>=4.2
+Requires-Dist: pydantic-settings>=2.3
+Requires-Dist: pydantic>=2.7
+Requires-Dist: rich>=13.7
+Requires-Dist: sqlalchemy>=2.0
+Requires-Dist: tomli>=2.0; python_version < '3.11'
+Requires-Dist: typer>=0.12
+Requires-Dist: uvicorn[standard]>=0.30
+Provides-Extra: dev
+Requires-Dist: mypy>=1.10; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
+Requires-Dist: pytest-cov>=5.0; extra == 'dev'
+Requires-Dist: pytest>=8.2; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+<div align="center">
+
+# Agent-ROI
+
+**Track the cost, usage, and ROI of your AI coding agents — across every tool.**
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)
+[![CI](https://github.com/Agent-ROI/agent-roi/actions/workflows/ci.yml/badge.svg)](https://github.com/Agent-ROI/agent-roi/actions/workflows/ci.yml)
+
+[English](./README.md) · [繁體中文](./README.zh.md)
+
+</div>
+
+---
+
+## What is Agent-ROI?
+
+When you use multiple AI coding tools — Claude Code, Codex CLI, GitHub Copilot, Cursor, and others — your token spend is scattered everywhere and impossible to evaluate. **Agent-ROI** unifies all of it.
+
+It reads the local session logs each tool already writes, uses a **model-free semantic classifier** to discover *what topic / task* each session was about, and then shows you **how many tokens each topic consumed** — so you can measure the **return on investment** of your agents, not just raw token counts.
+
+> The core question Agent-ROI answers: *"For this feature / bug / topic, how many tokens did my agents burn — and was it worth it?"*
+
+## Features
+
+- 🔌 **Tool-agnostic collectors** — parse local logs from Claude Code, Codex CLI, GitHub Copilot, and Gemini CLI (no proxy, no workflow change).
+- 🧠 **Topic classification** — a model-free semantic classifier groups sessions by topic so you see cost *per subject*, not per request. Runs fully offline, costs nothing, requires no external service.
+- 💰 **Cost & ROI tracking** — token usage mapped to per-model pricing, aggregated by **topic, tool, or model**, over a **custom time window**.
+- 🔎 **Drill-down & trust** — click any topic to see which tools and models its tokens came from; every figure is backed by a **viewable pricing table**, and estimated numbers are clearly badged vs exact ones.
+- 🖥️ **CLI** — `report`, per-topic drill-down, and a `pricing` command straight from the terminal.
+- 🌐 **Web UI** — a modern React dashboard with dimension/time controls, breakdowns, and drill-downs.
+- 🗄️ **Local-first** — everything stays on your machine (SQLite); fully offline; classification never sends data anywhere.
+
+## Architecture
+
+```
+┌──────────────┐   ┌──────────────┐   ┌──────────────┐
+│  Collectors  │──▶│  Classifier  │──▶│   Storage    │
+│ (parse logs) │   │  (semantic)  │   │  (SQLite)    │
+└──────────────┘   └──────────────┘   └──────┬───────┘
+                                             │
+                          ┌──────────────────┼──────────────────┐
+                          ▼                                      ▼
+                   ┌────────────┐                        ┌────────────┐
+                   │    CLI     │                        │  REST API  │──▶ Web UI (React)
+                   └────────────┘                        └────────────┘
+```
+
+See [docs/architecture.md](./docs/architecture.md) for details.
+
+## Install
+
+One line (macOS / Linux / WSL). Installs `uv` if needed, then the `agent-roi` command:
+
+```bash
+curl -LsSf https://raw.githubusercontent.com/Agent-ROI/agent-roi/main/scripts/install.sh | sh
+```
+
+<details>
+<summary>Other ways to install</summary>
+
+```bash
+# With pipx
+pipx install agent-roi
+
+# With uv
+uv tool install agent-roi
+```
+
+To install the latest from source before a release is published, set
+`AGENT_ROI_FROM_GIT=1` before running the install script.
+</details>
+
+## Quick Start
+
+```bash
+# Ingest logs from all detected tools
+agent-roi ingest
+
+# Discover topics from your sessions (model-free, fully local)
+agent-roi classify
+
+# Cost breakdown — group by topic, tool, or model, over a time window
+agent-roi report --by tool --since 7d
+
+# Drill into one topic: which tools/models did its tokens come from?
+agent-roi topic "auth refactor"
+
+# Inspect the pricing table behind every cost figure
+agent-roi pricing
+
+# Launch the web dashboard (API + React UI), then open http://127.0.0.1:8000
+agent-roi serve
+```
+
+> Developing Agent-ROI itself? See [CONTRIBUTING.md](./CONTRIBUTING.md) — local
+> dev uses `uv` and runs the frontend on a separate Vite dev server.
+
+## Configuration
+
+Agent-ROI looks for config at `~/.config/agent-roi/config.toml`. See [docs/configuration.md](./docs/configuration.md).
+
+```toml
+[classifier]
+similarity_threshold = 0.18   # higher = more, smaller topics
+label_terms = 3               # words used to name each topic
+
+[collectors]
+enabled = ["claude_code", "codex", "copilot", "gemini"]
+```
+
+## Documentation
+
+| Doc | English | 繁體中文 |
+|-----|---------|----------|
+| Architecture | [architecture.md](./docs/architecture.md) | [architecture.zh.md](./docs/architecture.zh.md) |
+| Configuration | [configuration.md](./docs/configuration.md) | [configuration.zh.md](./docs/configuration.zh.md) |
+| Collectors | [collectors.md](./docs/collectors.md) | [collectors.zh.md](./docs/collectors.zh.md) |
+| Contributing | [CONTRIBUTING.md](./CONTRIBUTING.md) | [CONTRIBUTING.zh.md](./CONTRIBUTING.zh.md) |
+
+## Contributing
+
+Contributions are welcome! Please read [CONTRIBUTING.md](./CONTRIBUTING.md) and our [Code of Conduct](./CODE_OF_CONDUCT.md).
+
+## License
+
+[MIT](./LICENSE) © Agent-ROI contributors