@contextgraph/agent 0.4.0 → 0.4.2
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/.claude/settings.local.json +8 -1
- package/CHANGELOG.md +1 -1
- package/README.md +17 -17
- package/dist/index.js +449 -39
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
|
@@ -24,7 +24,14 @@
|
|
|
24
24
|
"Bash(npm publish:*)",
|
|
25
25
|
"Bash(cat:*)",
|
|
26
26
|
"WebSearch",
|
|
27
|
-
"Bash(claude:*)"
|
|
27
|
+
"Bash(claude:*)",
|
|
28
|
+
"Bash(find:*)",
|
|
29
|
+
"Bash(grep:*)",
|
|
30
|
+
"Bash(vercel logs:*)",
|
|
31
|
+
"Bash(vercel inspect:*)",
|
|
32
|
+
"Bash(pnpm install:*)",
|
|
33
|
+
"Bash(gh pr view:*)",
|
|
34
|
+
"Bash(gh pr diff:*)"
|
|
28
35
|
],
|
|
29
36
|
"deny": [],
|
|
30
37
|
"ask": []
|
package/CHANGELOG.md
CHANGED
|
@@ -16,7 +16,7 @@ All notable changes to this project will be documented in this file.
|
|
|
16
16
|
## [0.1.0] - 2025-11-15
|
|
17
17
|
|
|
18
18
|
### Added
|
|
19
|
-
- Initial release of @
|
|
19
|
+
- Initial release of @contextgraph/agent
|
|
20
20
|
- OAuth authentication with contextgraph.dev
|
|
21
21
|
- CLI commands: auth, whoami, run, prepare, execute
|
|
22
22
|
- Autonomous agent loop with tree traversal
|
package/README.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# @
|
|
1
|
+
# @contextgraph/agent
|
|
2
2
|
|
|
3
3
|
Autonomous agent for contextgraph action execution.
|
|
4
4
|
|
|
@@ -7,13 +7,13 @@ Autonomous agent for contextgraph action execution.
|
|
|
7
7
|
No installation required! Use npx to run commands directly:
|
|
8
8
|
|
|
9
9
|
```bash
|
|
10
|
-
npx @
|
|
10
|
+
npx @contextgraph/agent <command>
|
|
11
11
|
```
|
|
12
12
|
|
|
13
13
|
Or install globally for convenience:
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
-
npm install -g @
|
|
16
|
+
npm install -g @contextgraph/agent
|
|
17
17
|
```
|
|
18
18
|
|
|
19
19
|
## Prerequisites
|
|
@@ -28,13 +28,13 @@ npm install -g @context-graph/agent
|
|
|
28
28
|
1. Authenticate with contextgraph.dev:
|
|
29
29
|
|
|
30
30
|
```bash
|
|
31
|
-
npx @
|
|
31
|
+
npx @contextgraph/agent auth
|
|
32
32
|
```
|
|
33
33
|
|
|
34
34
|
2. Run the agent:
|
|
35
35
|
|
|
36
36
|
```bash
|
|
37
|
-
npx @
|
|
37
|
+
npx @contextgraph/agent run
|
|
38
38
|
```
|
|
39
39
|
|
|
40
40
|
### Option 2: API Token (CI/CD & Cloud Deployments)
|
|
@@ -43,7 +43,7 @@ For automated environments, use an API token:
|
|
|
43
43
|
|
|
44
44
|
```bash
|
|
45
45
|
export CONTEXTGRAPH_API_TOKEN="your-api-token"
|
|
46
|
-
npx @
|
|
46
|
+
npx @contextgraph/agent run
|
|
47
47
|
```
|
|
48
48
|
|
|
49
49
|
Get your API token from https://contextgraph.dev/settings/tokens
|
|
@@ -54,7 +54,7 @@ Get your API token from https://contextgraph.dev/settings/tokens
|
|
|
54
54
|
Authenticate with contextgraph.dev using OAuth:
|
|
55
55
|
|
|
56
56
|
```bash
|
|
57
|
-
npx @
|
|
57
|
+
npx @contextgraph/agent auth
|
|
58
58
|
```
|
|
59
59
|
|
|
60
60
|
Opens your browser to complete authentication. Credentials are securely stored in `~/.contextgraph/`.
|
|
@@ -63,7 +63,7 @@ Opens your browser to complete authentication. Credentials are securely stored i
|
|
|
63
63
|
Check your current authentication status:
|
|
64
64
|
|
|
65
65
|
```bash
|
|
66
|
-
npx @
|
|
66
|
+
npx @contextgraph/agent whoami
|
|
67
67
|
```
|
|
68
68
|
|
|
69
69
|
Shows your user ID and token expiration.
|
|
@@ -72,7 +72,7 @@ Shows your user ID and token expiration.
|
|
|
72
72
|
Run the autonomous agent loop:
|
|
73
73
|
|
|
74
74
|
```bash
|
|
75
|
-
npx @
|
|
75
|
+
npx @contextgraph/agent run <action-id>
|
|
76
76
|
```
|
|
77
77
|
|
|
78
78
|
The agent will:
|
|
@@ -86,7 +86,7 @@ The agent will:
|
|
|
86
86
|
Prepare a single action:
|
|
87
87
|
|
|
88
88
|
```bash
|
|
89
|
-
npx @
|
|
89
|
+
npx @contextgraph/agent prepare <action-id>
|
|
90
90
|
```
|
|
91
91
|
|
|
92
92
|
Spawns Claude to assess whether the action should be broken down into child actions or is ready to execute.
|
|
@@ -95,7 +95,7 @@ Spawns Claude to assess whether the action should be broken down into child acti
|
|
|
95
95
|
Execute a single prepared action:
|
|
96
96
|
|
|
97
97
|
```bash
|
|
98
|
-
npx @
|
|
98
|
+
npx @contextgraph/agent execute <action-id>
|
|
99
99
|
```
|
|
100
100
|
|
|
101
101
|
Spawns Claude to implement the action and mark it complete.
|
|
@@ -133,7 +133,7 @@ The agent integrates with contextgraph.dev's MCP server to:
|
|
|
133
133
|
If authentication fails or tokens expire:
|
|
134
134
|
|
|
135
135
|
```bash
|
|
136
|
-
npx @
|
|
136
|
+
npx @contextgraph/agent auth
|
|
137
137
|
```
|
|
138
138
|
|
|
139
139
|
This will open a new browser session to re-authenticate.
|
|
@@ -143,8 +143,8 @@ This will open a new browser session to re-authenticate.
|
|
|
143
143
|
Tokens expire after a period of time. Re-authenticate with:
|
|
144
144
|
|
|
145
145
|
```bash
|
|
146
|
-
npx @
|
|
147
|
-
npx @
|
|
146
|
+
npx @contextgraph/agent whoami # Check expiration
|
|
147
|
+
npx @contextgraph/agent auth # Re-authenticate if expired
|
|
148
148
|
```
|
|
149
149
|
|
|
150
150
|
### Network errors
|
|
@@ -156,8 +156,8 @@ Ensure you have internet connectivity and can reach:
|
|
|
156
156
|
## Links
|
|
157
157
|
|
|
158
158
|
- [contextgraph.dev](https://contextgraph.dev) - Main platform
|
|
159
|
-
- [GitHub Repository](https://github.com/
|
|
160
|
-
- [Issue Tracker](https://github.com/
|
|
159
|
+
- [GitHub Repository](https://github.com/contextgraph/agent) - Source code and issues
|
|
160
|
+
- [Issue Tracker](https://github.com/contextgraph/agent/issues) - Report bugs or request features
|
|
161
161
|
|
|
162
162
|
## Configuration
|
|
163
163
|
|
|
@@ -197,7 +197,7 @@ When no work is available, the worker waits before polling again. The wait time
|
|
|
197
197
|
Example:
|
|
198
198
|
```bash
|
|
199
199
|
# Poll more frequently (every 1 second initially, up to 15 seconds max)
|
|
200
|
-
WORKER_INITIAL_POLL_INTERVAL=1000 WORKER_MAX_POLL_INTERVAL=15000 npx @
|
|
200
|
+
WORKER_INITIAL_POLL_INTERVAL=1000 WORKER_MAX_POLL_INTERVAL=15000 npx @contextgraph/agent run <action-id>
|
|
201
201
|
```
|
|
202
202
|
|
|
203
203
|
### Claude Agent SDK
|