agent-insights 0.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/README.md +63 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +1017 -0
- package/dist/cli.js.map +1 -0
- package/dist/index.d.ts +156 -0
- package/dist/index.js +484 -0
- package/dist/index.js.map +1 -0
- package/package.json +61 -0
package/README.md
ADDED
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
# agent-insights
|
|
2
|
+
|
|
3
|
+
CLI for AI coding agent lifecycle observability. Installs hooks into Claude
|
|
4
|
+
Code and Cursor, uploads session transcripts to Vercel Blob, and (optionally)
|
|
5
|
+
hands them off to an Ash analyzer that posts a digest to Slack and produces
|
|
6
|
+
pre-filled GitHub issue URLs.
|
|
7
|
+
|
|
8
|
+
> Internal tool from [vercel-labs/agent-insights](https://github.com/vercel-labs/agent-insights). See [SPEC.md](https://github.com/vercel-labs/agent-insights/blob/main/SPEC.md) for the full design.
|
|
9
|
+
|
|
10
|
+
## Install
|
|
11
|
+
|
|
12
|
+
```bash
|
|
13
|
+
npm i -g agent-insights
|
|
14
|
+
# or
|
|
15
|
+
pnpm add -g agent-insights
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
## Quick start
|
|
19
|
+
|
|
20
|
+
```bash
|
|
21
|
+
agent-insights init # writes config + installs Claude/Cursor hooks
|
|
22
|
+
agent-insights status # shows config, consent, adapter state
|
|
23
|
+
agent-insights doctor # validates config, Blob, hooks
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
`init` writes `~/.agent-insights/config.json` and installs hook entries into
|
|
27
|
+
the current repo's `.claude/settings.json` and `.cursor/hooks.json`.
|
|
28
|
+
|
|
29
|
+
## Commands
|
|
30
|
+
|
|
31
|
+
| Command | Purpose |
|
|
32
|
+
|---------|---------|
|
|
33
|
+
| `agent-insights init` | Write config + install Claude Code/Cursor hooks |
|
|
34
|
+
| `agent-insights status` | Show config, consent, and adapter state |
|
|
35
|
+
| `agent-insights doctor` | Validate config, Blob, hooks |
|
|
36
|
+
| `agent-insights disable [--agent X] [--purge]` | Remove hooks and/or wipe state |
|
|
37
|
+
| `agent-insights hook <event>` | Invoked by agent hook configs (stdin = JSON) |
|
|
38
|
+
| `agent-insights cursor [path]` | Launch Cursor with session start/end |
|
|
39
|
+
|
|
40
|
+
## Environment
|
|
41
|
+
|
|
42
|
+
| Variable | Purpose |
|
|
43
|
+
|----------|---------|
|
|
44
|
+
| `BLOB_READ_WRITE_TOKEN` | Required for transcript upload (from `vercel env pull`) |
|
|
45
|
+
| `AGENT_INSIGHTS_ANALYZER_URL` | Optional Phase 2 analyzer endpoint |
|
|
46
|
+
| `AGENT_INSIGHTS_INGEST_SECRET` | Optional shared secret sent to analyzer |
|
|
47
|
+
| `AGENT_INSIGHTS_DEBUG=1` | Verbose debug to stderr |
|
|
48
|
+
| `AGENT_INSIGHTS_HOME` | Override config root (default `~/.agent-insights`) |
|
|
49
|
+
| `AGENT_INSIGHTS_OTEL_ENDPOINT` | Phase 3 OTLP endpoint |
|
|
50
|
+
|
|
51
|
+
## Develop locally
|
|
52
|
+
|
|
53
|
+
```bash
|
|
54
|
+
git clone https://github.com/vercel-labs/agent-insights.git
|
|
55
|
+
cd agent-insights
|
|
56
|
+
pnpm install
|
|
57
|
+
pnpm --filter agent-insights build
|
|
58
|
+
node packages/cli/dist/cli.js --help
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
## License
|
|
62
|
+
|
|
63
|
+
Apache-2.0.
|
package/dist/cli.d.ts
ADDED