pokegent 2.0.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +167 -0
- package/dist/index.js +11567 -0
- package/package.json +45 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Shafiq Imtiaz
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,167 @@
|
|
|
1
|
+
<!-- prettier-ignore -->
|
|
2
|
+
<div align="center">
|
|
3
|
+
|
|
4
|
+
# ◓ Pokégent
|
|
5
|
+
|
|
6
|
+
[](https://nodejs.org)
|
|
7
|
+
[](https://github.com/vadimdemedes/ink)
|
|
8
|
+
[](LICENSE)
|
|
9
|
+
<br>
|
|
10
|
+
[](https://github.com/shafiqimtiaz/pokegent/releases)
|
|
11
|
+
[](https://github.com/shafiqimtiaz/pokegent)
|
|
12
|
+
|
|
13
|
+
Terminal dashboard that shows what's running in your Pokémon AI coding ecosystem — 16 Pokémon species (CLI) detectors, TMs/HMs (MCP) discovery, movepool usage charts, PP burn metrics, and a shareable HTML Trainer Card with animated sprites.
|
|
14
|
+
|
|
15
|
+
[Features](#features) • [Installation](#installation) • [Usage](#usage) • [Share](#share-your-setup)
|
|
16
|
+
|
|
17
|
+
</div>
|
|
18
|
+
|
|
19
|
+
Pokégent is a Node.js TUI that scans your local machine to give you a live picture of your Pokémon AI tooling landscape. It detects running AI processes as Pokémon, finds TMs/HMs (installed MCP servers), tallies movepool (model) usage from shell history and log files, and estimates PP burn rates (tokens) — all without ever making a network request.
|
|
20
|
+
|
|
21
|
+
> [!NOTE]
|
|
22
|
+
> Pokégent runs entirely locally. No telemetry, no outbound calls, no external services. It reads the process table, configuration directories, and log files on your machine and renders the results in your terminal.
|
|
23
|
+
|
|
24
|
+
## Features
|
|
25
|
+
|
|
26
|
+
- **16 Pokémon species detectors** — Scans for Mewtwo, Venusaur, Blastoise, Pikachu, Eevee, Charizard, Charmander, Gengar, Snorlax, Zubat, Jigglypuff, Ditto, Machamp, Rayquaza, Lapras, and Dragonite
|
|
27
|
+
- **TM/HM (MCP) discovery** — Aggregates tool servers from `~/.claude`, `~/.cursor`, `~/.opencode`, `~/.n8n` and other standard config paths
|
|
28
|
+
- **Movepool (Model) frequency charts** — Parses terminal history and log files for model mentions, renders horizontal ASCII bars
|
|
29
|
+
- **PP (Token) burn analytics** — Battles (sessions), PP velocity, input/output splits, and estimated cost from local logs
|
|
30
|
+
- **Trainer scoring system** — 0-1000 points across Pokémon, TMs/HMs, movepool, and PP burn metrics
|
|
31
|
+
- **7 Trainer badges** — 🏆 Pokédex Master, 🦄 Legendary Trainer, 🧬 Hybrid Evolution, 🔥 Blast Burn, 💎 Elite Four, ⚡ Thunder Shock, 🌐 Safari Zone Master
|
|
32
|
+
- **Shareable HTML Trainer Card** — Generate a beautiful, self-contained HTML Trainer Card featuring animated showdown sprites for active Pokémon
|
|
33
|
+
- **2-second auto-refresh** — Live updates so you can watch your ecosystem change as you work
|
|
34
|
+
- **Demo mode** — Built-in realistic mock data for previews, screenshots, or evaluation
|
|
35
|
+
|
|
36
|
+
## Installation
|
|
37
|
+
|
|
38
|
+
```bash
|
|
39
|
+
# Run directly with npx (zero install)
|
|
40
|
+
npx pokegent
|
|
41
|
+
|
|
42
|
+
# Or install globally
|
|
43
|
+
npm install -g pokegent
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Usage
|
|
47
|
+
|
|
48
|
+
```bash
|
|
49
|
+
# Live TUI dashboard
|
|
50
|
+
npx pokegent
|
|
51
|
+
|
|
52
|
+
# Demo mode with mock data
|
|
53
|
+
npx pokegent --demo
|
|
54
|
+
|
|
55
|
+
# Generate shareable card + copy markdown to clipboard
|
|
56
|
+
npx pokegent --share
|
|
57
|
+
|
|
58
|
+
# Generate HTML card file
|
|
59
|
+
npx pokegent --html
|
|
60
|
+
|
|
61
|
+
# Export raw JSON data
|
|
62
|
+
npx pokegent --json
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
### Keyboard shortcuts (TUI mode)
|
|
66
|
+
|
|
67
|
+
| Key | Action |
|
|
68
|
+
|-----|--------|
|
|
69
|
+
| `q` | Quit the application |
|
|
70
|
+
| `r` | Force an immediate refresh |
|
|
71
|
+
| `s` | Share card (copy markdown to clipboard) |
|
|
72
|
+
| `h` | Generate HTML card |
|
|
73
|
+
|
|
74
|
+
## Share your setup
|
|
75
|
+
|
|
76
|
+
The viral mechanic: **press `s` to copy a markdown card to clipboard, or `h` to generate an HTML file.**
|
|
77
|
+
|
|
78
|
+
### Markdown card (for Discord, GitHub, Slack)
|
|
79
|
+
|
|
80
|
+
```bash
|
|
81
|
+
npx pokegent --share
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
This prints the terminal card AND copies a markdown version to your clipboard. Paste it anywhere.
|
|
85
|
+
|
|
86
|
+
### HTML Trainer Card (for GitHub Pages, Twitter, anywhere)
|
|
87
|
+
|
|
88
|
+
```bash
|
|
89
|
+
npx pokegent --html
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
This generates `pokegent.html` — a self-contained, dark-red/black themed, animated card featuring dynamic Pokémon gifs and OpenGraph meta tags for beautiful link previews. Drop it in a repo, open it in a browser, or share the raw link.
|
|
93
|
+
|
|
94
|
+
## Scoring
|
|
95
|
+
|
|
96
|
+
Your setup gets scored 0-1000 points:
|
|
97
|
+
|
|
98
|
+
| Dimension | Max Points | How |
|
|
99
|
+
|-----------|-----------|-----|
|
|
100
|
+
| Pokémon running | 350 | 75 per running Pokémon (cap 4) + 50 bonus for 3+ simultaneous |
|
|
101
|
+
| TMs & HMs (MCP) | 200 | 10 per server (cap 15) + 1 per tool (cap 50) |
|
|
102
|
+
| Movepool diversity | 200 | 30 per unique model (cap 5) + 50 for using 3+ providers |
|
|
103
|
+
| PP velocity + battles | 250 | PP velocity tiers + battle count |
|
|
104
|
+
|
|
105
|
+
### Rarity tiers
|
|
106
|
+
|
|
107
|
+
| Score | Tier |
|
|
108
|
+
|-------|------|
|
|
109
|
+
| 900+ | 🌟 MYTHICAL CHAMPION — Top 1% |
|
|
110
|
+
| 750+ | 💎 SHINY LEGENDARY — Top 5% |
|
|
111
|
+
| 600+ | 🥇 POKÉMON MASTER — Top 15% |
|
|
112
|
+
| 400+ | 🥈 GYM LEADER — Top 35% |
|
|
113
|
+
| 200+ | 🥉 ELITE TRAINER — Top 60% |
|
|
114
|
+
| <200 | 🌱 BEGINNER TRAINER — everyone starts here |
|
|
115
|
+
|
|
116
|
+
## What gets scanned
|
|
117
|
+
|
|
118
|
+
<details>
|
|
119
|
+
<summary><strong>16 Pokémon species and their detection signals</strong></summary>
|
|
120
|
+
|
|
121
|
+
| Pokémon | CLI Platform | Process match | Config path |
|
|
122
|
+
|---------|--------------|---------------|-------------|
|
|
123
|
+
| Mewtwo | Claude Code | `claude*` | `~/.claude` |
|
|
124
|
+
| Venusaur | Codex | `codex*` | `~/.codex` |
|
|
125
|
+
| Blastoise | GitHub Copilot CLI | `copilot*` | `~/.copilot` |
|
|
126
|
+
| Pikachu | Gemini CLI | `gemini*` | `~/.gemini` |
|
|
127
|
+
| Eevee | Cursor | `cursor` | `~/.cursor` |
|
|
128
|
+
| Charizard | Amp | `amp*` | `~/.amp` |
|
|
129
|
+
| Charmander | Cline | — | `~/.cline`, VS Code ext |
|
|
130
|
+
| Gengar | Roo Code | `roo*` | `~/.roo` |
|
|
131
|
+
| Snorlax | Kilo Code | `kilo*` | `~/.kilo` |
|
|
132
|
+
| Zubat | Kiro | `kiro` | `~/.kiro` |
|
|
133
|
+
| Jigglypuff | Crush | — | `~/.crush` |
|
|
134
|
+
| Ditto | OpenCode | `opencode` | `~/.opencode` |
|
|
135
|
+
| Machamp | Factory Droid | `factory-droid` | `~/.factory-droid` |
|
|
136
|
+
| Rayquaza | Antigravity | `antigravity*` | `~/.antigravity` |
|
|
137
|
+
| Lapras | Kimi CLI | `kimi*` | `~/.kimi` |
|
|
138
|
+
| Dragonite | Qwen Code | `qwen*` | `~/.qwen` |
|
|
139
|
+
|
|
140
|
+
</details>
|
|
141
|
+
|
|
142
|
+
<details>
|
|
143
|
+
<summary><strong>Scanned moves / models (19 patterns)</strong></summary>
|
|
144
|
+
|
|
145
|
+
claude-4-opus, claude-4-sonnet, claude-3.7-sonnet, claude-3.5-sonnet, claude-3-haiku, gpt-4.1, gpt-4o, gpt-4-turbo, o4-mini, o3, o3-mini, o3-pro, gemini-2.5-pro, gemini-2.5-flash, gemini-2.0-flash, deepseek-v3, deepseek-r1, qwen-3, llama-4
|
|
146
|
+
|
|
147
|
+
</details>
|
|
148
|
+
|
|
149
|
+
## Tech stack
|
|
150
|
+
|
|
151
|
+
- **[Ink](https://github.com/vadimdemedes/ink)** — React for CLI. Provides the TUI framework.
|
|
152
|
+
- **[ps-list](https://github.com/sindresorhus/ps-list)** — Cross-platform process listing.
|
|
153
|
+
- **Node.js 18+** — All scanning logic uses built-in modules (`fs`, `path`, `child_process`).
|
|
154
|
+
|
|
155
|
+
## Running from source
|
|
156
|
+
|
|
157
|
+
```bash
|
|
158
|
+
git clone https://github.com/shafiqimtiaz/pokegent.git
|
|
159
|
+
cd pokegent
|
|
160
|
+
npm install
|
|
161
|
+
npx tsx src/index.ts --demo
|
|
162
|
+
npx tsx src/index.ts
|
|
163
|
+
```
|
|
164
|
+
|
|
165
|
+
## Privacy
|
|
166
|
+
|
|
167
|
+
Pokégent runs 100% locally. No data leaves your machine. No telemetry. No analytics. No network requests. Your AI tooling data stays on your computer.
|