@codexview/react 0.1.2 → 0.1.4
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/README.md +19 -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 +27 -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 +2 -2
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,17 @@ 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__*` / `Agent` tools; subagent transcripts are loaded from the `subagents/` subfolder and embedded as a Markdown summary under each `Agent` tool call
|
|
47
|
+
- 🔲 **OpenCode** — planned
|
|
48
|
+
|
|
49
|
+
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.
|
|
50
|
+
|
|
38
51
|
## Status
|
|
39
52
|
|
|
40
53
|
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 +63,7 @@ Session-level status (`idle | working | completed | stopped | failed`) is inferr
|
|
|
50
63
|
- [docs/events.md](docs/events.md) — `ChatStreamEvent` contract
|
|
51
64
|
- [docs/styling.md](docs/styling.md) — CSS variables
|
|
52
65
|
- [docs/integration-agentweb.md](docs/integration-agentweb.md) — drop-in for agentweb
|
|
66
|
+
- [docs/changelog.md](docs/changelog.md) — version history
|
|
53
67
|
|
|
54
68
|
## License
|
|
55
69
|
|
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.4";
|
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.4";
|
|
13498
13498
|
export {
|
|
13499
13499
|
CodexTranscript,
|
|
13500
13500
|
EMPTY_MODEL,
|