@codexview/react 0.1.1 → 0.1.3
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 +20 -5
- package/dist/index.d.ts +1 -1
- package/dist/index.js +1 -1
- package/dist/index.js.map +1 -1
- package/docs/changelog.md +23 -0
- package/docs/superpowers/plans/2026-05-15-claude-code-adapter-implementation.md +2005 -0
- package/docs/superpowers/specs/2026-05-15-claude-code-adapter-design.md +402 -0
- package/package.json +6 -5
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Jay Liu (maxazure)
|
|
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
CHANGED
|
@@ -1,24 +1,26 @@
|
|
|
1
1
|
# codexview
|
|
2
2
|
|
|
3
|
-
React components for rendering
|
|
3
|
+
React components for rendering AI coding agent transcripts. The library consumes a normalized `ChatStreamEvent` stream and is host-agnostic — any source that produces compatible events renders identically.
|
|
4
|
+
|
|
5
|
+
Reference adapters for several real-world agent log formats live in [`playground/adapter.mjs`](playground/adapter.mjs); see [Supported sources](#supported-sources) below.
|
|
4
6
|
|
|
5
7
|
## Install
|
|
6
8
|
|
|
7
9
|
```bash
|
|
8
|
-
pnpm add codexview lucide-react react react-dom
|
|
10
|
+
pnpm add @codexview/react lucide-react react react-dom
|
|
9
11
|
```
|
|
10
12
|
|
|
11
13
|
Import the stylesheet once in your app entrypoint:
|
|
12
14
|
|
|
13
15
|
```ts
|
|
14
|
-
import 'codexview/styles.css';
|
|
16
|
+
import '@codexview/react/styles.css';
|
|
15
17
|
```
|
|
16
18
|
|
|
17
19
|
## 60-second quick start
|
|
18
20
|
|
|
19
21
|
```tsx
|
|
20
|
-
import { CodexTranscript, type ChatStreamEvent } from 'codexview';
|
|
21
|
-
import 'codexview/styles.css';
|
|
22
|
+
import { CodexTranscript, type ChatStreamEvent } from '@codexview/react';
|
|
23
|
+
import '@codexview/react/styles.css';
|
|
22
24
|
|
|
23
25
|
const events: ChatStreamEvent[] = [
|
|
24
26
|
{ type: 'thread_started', threadId: 'T', at: Date.now() },
|
|
@@ -35,6 +37,18 @@ export function App() {
|
|
|
35
37
|
|
|
36
38
|
`events` is a plain array. Append new events as they arrive (typically via SSE) and pass the same array reference back; CodexView reduces incrementally.
|
|
37
39
|
|
|
40
|
+
## Supported sources
|
|
41
|
+
|
|
42
|
+
CodexView itself only renders `ChatStreamEvent[]`. Hosts convert their raw logs to that shape — either inline or by reusing the reference adapters in [`playground/adapter.mjs`](playground/adapter.mjs):
|
|
43
|
+
|
|
44
|
+
- ✅ **OpenAI Codex CLI** rollouts (`~/.codex/sessions/.../rollout-*.jsonl`)
|
|
45
|
+
- ✅ **AgentWeb codex-team** status logs (`~/Projects/agentweb/.codex-team/runs/*/events.jsonl`)
|
|
46
|
+
- ✅ **Claude Code** main sessions (`~/.claude/projects/<repo>/<sessionId>.jsonl`) — Bash / TodoWrite / Edit / Write / MultiEdit / `mcp__*` tools, with sensible fallbacks for unknown tools
|
|
47
|
+
- 🔲 **OpenCode** — planned
|
|
48
|
+
- 🔲 **Claude Code subagents** (`subagents/agent-*.jsonl`) — planned (will link to the parent `Task` tool call)
|
|
49
|
+
|
|
50
|
+
These adapters are not published as part of `@codexview/react` yet. To try them locally, clone the repo and run `pnpm playground` — it scans your home directory for sessions across all three supported formats.
|
|
51
|
+
|
|
38
52
|
## Status
|
|
39
53
|
|
|
40
54
|
Session-level status (`idle | working | completed | stopped | failed`) is inferred automatically. Override via the `status` prop (e.g. when SSE drops, set `status="stopped"`).
|
|
@@ -50,6 +64,7 @@ Session-level status (`idle | working | completed | stopped | failed`) is inferr
|
|
|
50
64
|
- [docs/events.md](docs/events.md) — `ChatStreamEvent` contract
|
|
51
65
|
- [docs/styling.md](docs/styling.md) — CSS variables
|
|
52
66
|
- [docs/integration-agentweb.md](docs/integration-agentweb.md) — drop-in for agentweb
|
|
67
|
+
- [docs/changelog.md](docs/changelog.md) — version history
|
|
53
68
|
|
|
54
69
|
## License
|
|
55
70
|
|
package/dist/index.d.ts
CHANGED
|
@@ -35,4 +35,4 @@ export { ItemErrorBoundary } from './components/ItemErrorBoundary.js';
|
|
|
35
35
|
export type { ItemErrorBoundaryProps } from './components/ItemErrorBoundary.js';
|
|
36
36
|
export { Markdown } from './components/Markdown.js';
|
|
37
37
|
export type { MarkdownProps } from './components/Markdown.js';
|
|
38
|
-
export declare const VERSION = "0.1.
|
|
38
|
+
export declare const VERSION = "0.1.3";
|
package/dist/index.js
CHANGED
|
@@ -13494,7 +13494,7 @@ function renderItem(item, c, disableSmoothStream) {
|
|
|
13494
13494
|
return /* @__PURE__ */ jsx(c.RawEventBlock, { item });
|
|
13495
13495
|
}
|
|
13496
13496
|
}
|
|
13497
|
-
const VERSION = "0.1.
|
|
13497
|
+
const VERSION = "0.1.3";
|
|
13498
13498
|
export {
|
|
13499
13499
|
CodexTranscript,
|
|
13500
13500
|
EMPTY_MODEL,
|