clicodelog 0.1.0__tar.gz → 0.2.1__tar.gz

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.
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: clicodelog
3
- Version: 0.1.0
3
+ Version: 0.2.1
4
4
  Summary: A lightweight, local-first web app to browse, inspect, and export logs from CLI-based AI coding agents
5
5
  Author: monk1337
6
6
  License-Expression: MIT
@@ -25,8 +25,9 @@ Classifier: Topic :: Utilities
25
25
  Requires-Python: >=3.7
26
26
  Description-Content-Type: text/markdown
27
27
  License-File: LICENSE
28
- Requires-Dist: flask>=2.0
29
- Requires-Dist: flask-cors>=3.0
28
+ Requires-Dist: fastapi>=0.104.0
29
+ Requires-Dist: uvicorn[standard]>=0.24.0
30
+ Requires-Dist: jinja2>=3.1.0
30
31
  Provides-Extra: dev
31
32
  Requires-Dist: pytest>=7.0; extra == "dev"
32
33
  Requires-Dist: build; extra == "dev"
@@ -34,7 +35,10 @@ Requires-Dist: twine; extra == "dev"
34
35
  Dynamic: license-file
35
36
 
36
37
  <div align="center">
37
- <h1>cli code log</h1>
38
+ <div align="center">
39
+ <img width="220px" src="https://raw.githubusercontent.com/monk1337/clicodelog/refs/heads/main/screenshots/logo.png">
40
+ </div>
41
+
38
42
  <p>
39
43
  A lightweight, local-first web app to browse, inspect, and export logs from
40
44
  CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
@@ -50,7 +54,7 @@ CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
50
54
 
51
55
  <p>
52
56
  <img src="https://img.shields.io/badge/Python-3.7+-blue.svg" alt="Python 3.7+" />
53
- <img src="https://img.shields.io/badge/Flask-2.0+-green.svg" alt="Flask" />
57
+ <img src="https://img.shields.io/badge/FastAPI-0.104+-00c7b7.svg" alt="FastAPI" />
54
58
  <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License MIT" />
55
59
  <a href="http://makeapullrequest.com">
56
60
  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome" />
@@ -58,10 +62,97 @@ CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
58
62
  </p>
59
63
  </div>
60
64
 
61
- ![Gemini CLI Screenshot](screenshots/dark.png)
65
+ <!-- <div align="center">
66
+ <table>
67
+ <tr>
68
+ <td align="center">
69
+ <img src="screenshots/claude.png" width="80" alt="Claude Code"><br>
70
+ <sub><b>Claude Code</b></sub>
71
+ </td>
72
+ <td align="center">
73
+ <img src="screenshots/codex.png" width="80" alt="OpenAI Codex"><br>
74
+ <sub><b>OpenAI Codex</b></sub>
75
+ </td>
76
+ <td align="center">
77
+ <img src="screenshots/gemini.png" width="80" alt="Gemini CLI"><br>
78
+ <sub><b>Gemini CLI</b></sub>
79
+ </td>
80
+ </tr>
81
+ </table>
82
+ </div> -->
62
83
 
63
84
  ---
64
85
 
86
+ ## Installation
87
+
88
+ ### Via uv tool (Recommended)
89
+
90
+ [uv](https://github.com/astral-sh/uv) is a fast Python package installer. Install it first if you haven't:
91
+
92
+ ```bash
93
+ curl -LsSf https://astral.sh/uv/install.sh | sh
94
+ ```
95
+
96
+ Then install clicodelog as an isolated tool:
97
+
98
+ ```bash
99
+ uv tool install clicodelog
100
+ ```
101
+
102
+ To upgrade:
103
+ ```bash
104
+ uv tool upgrade clicodelog
105
+ ```
106
+
107
+ ### Via pip
108
+
109
+ ```bash
110
+ pip install clicodelog
111
+ ```
112
+
113
+ ### From source
114
+
115
+ ```bash
116
+ git clone https://github.com/monk1337/clicodelog.git
117
+ cd clicodelog
118
+ uv tool install -e .
119
+ # or with pip:
120
+ pip install -e .
121
+ ```
122
+
123
+ ---
124
+
125
+ ## Usage
126
+
127
+ After installation, simply run:
128
+
129
+ ```bash
130
+ clicodelog
131
+ ```
132
+
133
+ The app will:
134
+ - Auto-kill any process on port **6126** (if occupied)
135
+ - Sync data from all AI coding agent sources
136
+ - Start a web server at **http://localhost:6126**
137
+
138
+ ### Command Options
139
+
140
+ ```bash
141
+ clicodelog --help # Show all options
142
+ clicodelog --port 8080 # Use custom port
143
+ clicodelog --host 0.0.0.0 # Bind to all interfaces
144
+ clicodelog --no-sync # Skip initial data sync
145
+ clicodelog --debug # Run in debug mode
146
+ ```
147
+
148
+ ### Alternative: Run from source
149
+
150
+ ```bash
151
+ git clone https://github.com/monk1337/clicodelog.git
152
+ cd clicodelog
153
+ python -m clicodelog.cli
154
+ ```
155
+
65
156
  ## Features
66
157
 
67
158
  - **Multi-source support** — View logs from Claude Code, OpenAI Codex, and Gemini CLI
@@ -104,56 +195,18 @@ CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
104
195
 
105
196
  ---
106
197
 
107
- ## Installation
108
-
109
- ### Via pip (Recommended)
110
-
111
- ```bash
112
- pip install clicodelog
113
- ```
114
-
115
- ### From source
116
-
117
- ```bash
118
- git clone https://github.com/monk1337/clicodelog.git
119
- cd clicodelog
120
- pip install -e .
121
- ```
122
-
123
- ---
124
-
125
- ## Usage
126
-
127
- If installed via pip:
128
-
129
- ```bash
130
- clicodelog
131
- ```
132
-
133
- Or run directly from source:
134
-
135
- ```bash
136
- ./run.sh
137
- ```
138
-
139
- Or manually:
198
+ ### CLI Options
140
199
 
141
200
  ```bash
142
- pip install -r requirements.txt
143
- python app.py
201
+ clicodelog --help # Show help message
202
+ clicodelog --version # Show version
203
+ clicodelog --port 8080 # Run on custom port (default: 6126)
204
+ clicodelog --host 0.0.0.0 # Bind to all interfaces (default: 127.0.0.1)
205
+ clicodelog --no-sync # Skip initial data sync
206
+ clicodelog --debug # Run in debug mode
144
207
  ```
145
208
 
146
- Open http://localhost:5050 in your browser.
147
-
148
- ### CLI Options
149
-
150
- ```
151
- clicodelog --help
152
- clicodelog --port 8080 # Run on custom port
153
- clicodelog --host 0.0.0.0 # Bind to all interfaces
154
- clicodelog --no-sync # Skip initial data sync
155
- clicodelog --debug # Run in debug mode
156
- ```
209
+ **Note:** The app automatically kills any process running on the specified port before starting.
157
210
 
158
211
  ---
159
212
 
@@ -289,17 +342,3 @@ MIT
289
342
  </div>
290
343
 
291
344
  ```
292
-
293
- @misc{clicodelog2026,
294
- title = {clicodelog: Browse, inspect CLI-based AI coding agents},
295
- author = {Pal, Ankit},
296
- year = {2026},
297
- howpublished = {\url{https://github.com/monk1337/clicodelog}},
298
- note = {A lightweight, local-first web app to browse, inspect, and export logs from CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.}
299
- }
300
-
301
- ```
302
-
303
- ## 💁 Contributing
304
-
305
- Welcome any contributions to open source project, including new features, improvements to infrastructure, and more comprehensive documentation.
@@ -1,5 +1,8 @@
1
1
  <div align="center">
2
- <h1>cli code log</h1>
2
+ <div align="center">
3
+ <img width="220px" src="https://raw.githubusercontent.com/monk1337/clicodelog/refs/heads/main/screenshots/logo.png">
4
+ </div>
5
+
3
6
  <p>
4
7
  A lightweight, local-first web app to browse, inspect, and export logs from
5
8
  CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
@@ -15,7 +18,7 @@ CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
15
18
 
16
19
  <p>
17
20
  <img src="https://img.shields.io/badge/Python-3.7+-blue.svg" alt="Python 3.7+" />
18
- <img src="https://img.shields.io/badge/Flask-2.0+-green.svg" alt="Flask" />
21
+ <img src="https://img.shields.io/badge/FastAPI-0.104+-00c7b7.svg" alt="FastAPI" />
19
22
  <img src="https://img.shields.io/badge/License-MIT-yellow.svg" alt="License MIT" />
20
23
  <a href="http://makeapullrequest.com">
21
24
  <img src="https://img.shields.io/badge/PRs-welcome-brightgreen.svg?style=flat-square" alt="PRs Welcome" />
@@ -23,10 +26,97 @@ CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
23
26
  </p>
24
27
  </div>
25
28
 
26
- ![Gemini CLI Screenshot](screenshots/dark.png)
29
+ <!-- <div align="center">
30
+ <table>
31
+ <tr>
32
+ <td align="center">
33
+ <img src="screenshots/claude.png" width="80" alt="Claude Code"><br>
34
+ <sub><b>Claude Code</b></sub>
35
+ </td>
36
+ <td align="center">
37
+ <img src="screenshots/codex.png" width="80" alt="OpenAI Codex"><br>
38
+ <sub><b>OpenAI Codex</b></sub>
39
+ </td>
40
+ <td align="center">
41
+ <img src="screenshots/gemini.png" width="80" alt="Gemini CLI"><br>
42
+ <sub><b>Gemini CLI</b></sub>
43
+ </td>
44
+ </tr>
45
+ </table>
46
+ </div> -->
27
47
 
28
48
  ---
29
49
 
50
+ ## Installation
51
+
52
+ ### Via uv tool (Recommended)
53
+
54
+ [uv](https://github.com/astral-sh/uv) is a fast Python package installer. Install it first if you haven't:
55
+
56
+ ```bash
57
+ curl -LsSf https://astral.sh/uv/install.sh | sh
58
+ ```
59
+
60
+ Then install clicodelog as an isolated tool:
61
+
62
+ ```bash
63
+ uv tool install clicodelog
64
+ ```
65
+
66
+ To upgrade:
67
+ ```bash
68
+ uv tool upgrade clicodelog
69
+ ```
70
+
71
+ ### Via pip
72
+
73
+ ```bash
74
+ pip install clicodelog
75
+ ```
76
+
77
+ ### From source
78
+
79
+ ```bash
80
+ git clone https://github.com/monk1337/clicodelog.git
81
+ cd clicodelog
82
+ uv tool install -e .
83
+ # or with pip:
84
+ pip install -e .
85
+ ```
86
+
87
+ ---
88
+
89
+ ## Usage
90
+
91
+ After installation, simply run:
92
+
93
+ ```bash
94
+ clicodelog
95
+ ```
96
+
97
+ The app will:
98
+ - Auto-kill any process on port **6126** (if occupied)
99
+ - Sync data from all AI coding agent sources
100
+ - Start a web server at **http://localhost:6126**
101
+
102
+ ### Command Options
103
+
104
+ ```bash
105
+ clicodelog --help # Show all options
106
+ clicodelog --port 8080 # Use custom port
107
+ clicodelog --host 0.0.0.0 # Bind to all interfaces
108
+ clicodelog --no-sync # Skip initial data sync
109
+ clicodelog --debug # Run in debug mode
110
+ ```
111
+
112
+ ### Alternative: Run from source
113
+
114
+ ```bash
115
+ git clone https://github.com/monk1337/clicodelog.git
116
+ cd clicodelog
117
+ python -m clicodelog.cli
118
+ ```
119
+
30
120
  ## Features
31
121
 
32
122
  - **Multi-source support** — View logs from Claude Code, OpenAI Codex, and Gemini CLI
@@ -69,56 +159,18 @@ CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.
69
159
 
70
160
  ---
71
161
 
72
- ## Installation
73
-
74
- ### Via pip (Recommended)
75
-
76
- ```bash
77
- pip install clicodelog
78
- ```
79
-
80
- ### From source
81
-
82
- ```bash
83
- git clone https://github.com/monk1337/clicodelog.git
84
- cd clicodelog
85
- pip install -e .
86
- ```
87
-
88
- ---
89
-
90
- ## Usage
91
-
92
- If installed via pip:
93
-
94
- ```bash
95
- clicodelog
96
- ```
97
-
98
- Or run directly from source:
99
-
100
- ```bash
101
- ./run.sh
102
- ```
103
-
104
- Or manually:
162
+ ### CLI Options
105
163
 
106
164
  ```bash
107
- pip install -r requirements.txt
108
- python app.py
165
+ clicodelog --help # Show help message
166
+ clicodelog --version # Show version
167
+ clicodelog --port 8080 # Run on custom port (default: 6126)
168
+ clicodelog --host 0.0.0.0 # Bind to all interfaces (default: 127.0.0.1)
169
+ clicodelog --no-sync # Skip initial data sync
170
+ clicodelog --debug # Run in debug mode
109
171
  ```
110
172
 
111
- Open http://localhost:5050 in your browser.
112
-
113
- ### CLI Options
114
-
115
- ```
116
- clicodelog --help
117
- clicodelog --port 8080 # Run on custom port
118
- clicodelog --host 0.0.0.0 # Bind to all interfaces
119
- clicodelog --no-sync # Skip initial data sync
120
- clicodelog --debug # Run in debug mode
121
- ```
173
+ **Note:** The app automatically kills any process running on the specified port before starting.
122
174
 
123
175
  ---
124
176
 
@@ -254,17 +306,3 @@ MIT
254
306
  </div>
255
307
 
256
308
  ```
257
-
258
- @misc{clicodelog2026,
259
- title = {clicodelog: Browse, inspect CLI-based AI coding agents},
260
- author = {Pal, Ankit},
261
- year = {2026},
262
- howpublished = {\url{https://github.com/monk1337/clicodelog}},
263
- note = {A lightweight, local-first web app to browse, inspect, and export logs from CLI-based AI coding agents — Claude Code, OpenAI Codex, and Gemini CLI.}
264
- }
265
-
266
- ```
267
-
268
- ## 💁 Contributing
269
-
270
- Welcome any contributions to open source project, including new features, improvements to infrastructure, and more comprehensive documentation.
@@ -2,5 +2,5 @@
2
2
  CLI Code Log - Browse, inspect, and export logs from CLI-based AI coding agents.
3
3
  """
4
4
 
5
- __version__ = "0.1.0"
5
+ __version__ = "0.2.1"
6
6
  __author__ = "monk1337"