opencode-dashboard-server 0.1.0__tar.gz → 0.1.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.
@@ -0,0 +1,54 @@
1
+ Metadata-Version: 2.4
2
+ Name: opencode-dashboard-server
3
+ Version: 0.1.1
4
+ Summary: FastAPI aggregator over opencode's SQLite storage
5
+ Project-URL: Homepage, https://github.com/GCS-ZHN/opencode-dashboard
6
+ Requires-Python: >=3.10
7
+ Description-Content-Type: text/markdown
8
+ Requires-Dist: fastapi<1,>=0.115
9
+ Requires-Dist: uvicorn<1,>=0.30
10
+
11
+ # opencode-dashboard-server
12
+
13
+ FastAPI aggregation backend for the [opencode-dashboard](https://github.com/GCS-ZHN/opencode-dashboard)
14
+ project. Reads opencode's local SQLite storage via the `opencode db` CLI and exposes a JSON + SSE
15
+ API for the dashboard front end.
16
+
17
+ ## Install
18
+
19
+ ```bash
20
+ pip install opencode-dashboard-server
21
+ ```
22
+
23
+ Requires Python ≥ 3.10 and the `opencode` CLI on the same host (the server shells out to
24
+ `opencode db "<SQL>"` — it never opens the SQLite file directly, which is WAL-mode and actively
25
+ written while opencode runs).
26
+
27
+ ## Usage
28
+
29
+ On each host that runs opencode:
30
+
31
+ ```bash
32
+ uvicorn app:app --port 8791
33
+ ```
34
+
35
+ Run on more hosts with different ports (`8792`, `8793`, …) and point the front end at each.
36
+
37
+ ## API
38
+
39
+ - `GET /health` — liveness
40
+ - `GET /overview` — whole-host aggregate (tokens by type + cost, session counts, `updatedAt`)
41
+ - `GET /projects` — per-project rollups
42
+ - `GET /projects/{id}` — one project's sessions (parent/child tree)
43
+ - `GET /sessions/{id}` — per-model breakdown for one session (handles mid-conversation model switches)
44
+ - `GET /stream` — SSE: `updated` events when the DB changes (polled ~5s)
45
+
46
+ JSON is camelCase, timestamps are epoch-ms. Full contract in the repo's `API.md`.
47
+
48
+ ## Development
49
+
50
+ ```bash
51
+ uv sync # install deps (fastapi, uvicorn) + dev (pytest, httpx)
52
+ uv run pytest # run tests
53
+ uvx ruff check . # lint
54
+ ```
@@ -0,0 +1,44 @@
1
+ # opencode-dashboard-server
2
+
3
+ FastAPI aggregation backend for the [opencode-dashboard](https://github.com/GCS-ZHN/opencode-dashboard)
4
+ project. Reads opencode's local SQLite storage via the `opencode db` CLI and exposes a JSON + SSE
5
+ API for the dashboard front end.
6
+
7
+ ## Install
8
+
9
+ ```bash
10
+ pip install opencode-dashboard-server
11
+ ```
12
+
13
+ Requires Python ≥ 3.10 and the `opencode` CLI on the same host (the server shells out to
14
+ `opencode db "<SQL>"` — it never opens the SQLite file directly, which is WAL-mode and actively
15
+ written while opencode runs).
16
+
17
+ ## Usage
18
+
19
+ On each host that runs opencode:
20
+
21
+ ```bash
22
+ uvicorn app:app --port 8791
23
+ ```
24
+
25
+ Run on more hosts with different ports (`8792`, `8793`, …) and point the front end at each.
26
+
27
+ ## API
28
+
29
+ - `GET /health` — liveness
30
+ - `GET /overview` — whole-host aggregate (tokens by type + cost, session counts, `updatedAt`)
31
+ - `GET /projects` — per-project rollups
32
+ - `GET /projects/{id}` — one project's sessions (parent/child tree)
33
+ - `GET /sessions/{id}` — per-model breakdown for one session (handles mid-conversation model switches)
34
+ - `GET /stream` — SSE: `updated` events when the DB changes (polled ~5s)
35
+
36
+ JSON is camelCase, timestamps are epoch-ms. Full contract in the repo's `API.md`.
37
+
38
+ ## Development
39
+
40
+ ```bash
41
+ uv sync # install deps (fastapi, uvicorn) + dev (pytest, httpx)
42
+ uv run pytest # run tests
43
+ uvx ruff check . # lint
44
+ ```
@@ -0,0 +1,54 @@
1
+ Metadata-Version: 2.4
2
+ Name: opencode-dashboard-server
3
+ Version: 0.1.1
4
+ Summary: FastAPI aggregator over opencode's SQLite storage
5
+ Project-URL: Homepage, https://github.com/GCS-ZHN/opencode-dashboard
6
+ Requires-Python: >=3.10
7
+ Description-Content-Type: text/markdown
8
+ Requires-Dist: fastapi<1,>=0.115
9
+ Requires-Dist: uvicorn<1,>=0.30
10
+
11
+ # opencode-dashboard-server
12
+
13
+ FastAPI aggregation backend for the [opencode-dashboard](https://github.com/GCS-ZHN/opencode-dashboard)
14
+ project. Reads opencode's local SQLite storage via the `opencode db` CLI and exposes a JSON + SSE
15
+ API for the dashboard front end.
16
+
17
+ ## Install
18
+
19
+ ```bash
20
+ pip install opencode-dashboard-server
21
+ ```
22
+
23
+ Requires Python ≥ 3.10 and the `opencode` CLI on the same host (the server shells out to
24
+ `opencode db "<SQL>"` — it never opens the SQLite file directly, which is WAL-mode and actively
25
+ written while opencode runs).
26
+
27
+ ## Usage
28
+
29
+ On each host that runs opencode:
30
+
31
+ ```bash
32
+ uvicorn app:app --port 8791
33
+ ```
34
+
35
+ Run on more hosts with different ports (`8792`, `8793`, …) and point the front end at each.
36
+
37
+ ## API
38
+
39
+ - `GET /health` — liveness
40
+ - `GET /overview` — whole-host aggregate (tokens by type + cost, session counts, `updatedAt`)
41
+ - `GET /projects` — per-project rollups
42
+ - `GET /projects/{id}` — one project's sessions (parent/child tree)
43
+ - `GET /sessions/{id}` — per-model breakdown for one session (handles mid-conversation model switches)
44
+ - `GET /stream` — SSE: `updated` events when the DB changes (polled ~5s)
45
+
46
+ JSON is camelCase, timestamps are epoch-ms. Full contract in the repo's `API.md`.
47
+
48
+ ## Development
49
+
50
+ ```bash
51
+ uv sync # install deps (fastapi, uvicorn) + dev (pytest, httpx)
52
+ uv run pytest # run tests
53
+ uvx ruff check . # lint
54
+ ```
@@ -4,8 +4,9 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "opencode-dashboard-server"
7
- version = "0.1.0"
7
+ version = "0.1.1"
8
8
  description = "FastAPI aggregator over opencode's SQLite storage"
9
+ readme = "README.md"
9
10
  requires-python = ">=3.10"
10
11
  dependencies = [
11
12
  "fastapi>=0.115,<1",
@@ -1,8 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: opencode-dashboard-server
3
- Version: 0.1.0
4
- Summary: FastAPI aggregator over opencode's SQLite storage
5
- Project-URL: Homepage, https://github.com/GCS-ZHN/opencode-dashboard
6
- Requires-Python: >=3.10
7
- Requires-Dist: fastapi<1,>=0.115
8
- Requires-Dist: uvicorn<1,>=0.30
@@ -1,8 +0,0 @@
1
- Metadata-Version: 2.4
2
- Name: opencode-dashboard-server
3
- Version: 0.1.0
4
- Summary: FastAPI aggregator over opencode's SQLite storage
5
- Project-URL: Homepage, https://github.com/GCS-ZHN/opencode-dashboard
6
- Requires-Python: >=3.10
7
- Requires-Dist: fastapi<1,>=0.115
8
- Requires-Dist: uvicorn<1,>=0.30