create-bk-agent 0.17.2 → 0.18.0

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 CHANGED
@@ -11,7 +11,7 @@ npx create-bk-agent my-project
11
11
  The CLI asks three questions and generates a production-ready project:
12
12
 
13
13
  ```
14
- ✨ create-bk-agent v0.17.0
14
+ ✨ create-bk-agent v0.18.0
15
15
 
16
16
  ? Project name: my-project
17
17
  ? Architecture: Multi-agent (orchestrator + specialists)
@@ -109,6 +109,62 @@ All `add` commands are **idempotent** — running the same command twice won't d
109
109
 
110
110
  ---
111
111
 
112
+ ## Multi-project workspaces
113
+
114
+ Group related projects (e.g. microservices) into a workspace so the agent can navigate all of them from a single shared root — no more switching context manually.
115
+
116
+ ### Setup
117
+
118
+ Use the built-in `/workspace` slash commands from inside the running agent:
119
+
120
+ ```
121
+ /workspace create my-system
122
+ /workspace add my-system ~/dev/my-system/auth-service
123
+ /workspace add my-system ~/dev/my-system/api-gateway
124
+ /workspace add my-system ~/dev/my-system/user-service
125
+ ```
126
+
127
+ When a second project is added, a **common root** is auto-detected (`~/dev/my-system/`). The next `/workspace switch` sets that directory as the agent's working directory, giving it access to all services at once.
128
+
129
+ ### Commands
130
+
131
+ | Command | Description |
132
+ |---|---|
133
+ | `/workspace create <name>` | Create a workspace |
134
+ | `/workspace add <ws> <cwd> [name]` | Add a project |
135
+ | `/workspace import <cwd> [ws] [name]` | Add project (auto-creates workspace) |
136
+ | `/workspace switch <ws> [project]` | Switch to workspace (uses shared root if configured) |
137
+ | `/workspace set-root <ws> [path]` | Set shared root manually (auto-detected if no path) |
138
+ | `/workspace remove <ws> <project>` | Remove a project |
139
+ | `/workspace delete <name>` | Delete workspace |
140
+ | `/workspace list` | List all workspaces |
141
+
142
+ ### Shared root (microservices)
143
+
144
+ For a system with multiple services under a common parent:
145
+
146
+ ```
147
+ ~/dev/my-system/ ← shared root (agent workingDir)
148
+ ├── auth-service/
149
+ ├── api-gateway/
150
+ └── user-service/
151
+ ```
152
+
153
+ The agent can read and edit files across all services using relative paths:
154
+
155
+ ```
156
+ auth-service/src/middleware.ts
157
+ api-gateway/src/routes/auth.ts
158
+ ```
159
+
160
+ To override the auto-detected root:
161
+
162
+ ```
163
+ /workspace set-root my-system ~/dev/my-system
164
+ ```
165
+
166
+ ---
167
+
112
168
  ## Requirements
113
169
 
114
170
  - Node.js >= 20
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "create-bk-agent",
3
- "version": "0.17.2",
3
+ "version": "0.18.0",
4
4
  "description": "Create a new BackendKit agent project",
5
5
  "main": "dist/src/index.js",
6
6
  "bin": {
@@ -11,7 +11,7 @@
11
11
  "typecheck": "tsc --noEmit"
12
12
  },
13
13
  "dependencies": {
14
- "@backendkit-labs/agent-core": "^0.16.0",
14
+ "@backendkit-labs/agent-core": "^0.17.0",
15
15
  "dotenv": "^16.0.0"
16
16
  },
17
17
  "devDependencies": {
@@ -11,7 +11,7 @@
11
11
  "typecheck": "tsc --noEmit"
12
12
  },
13
13
  "dependencies": {
14
- "@backendkit-labs/agent-core": "^0.16.0",
14
+ "@backendkit-labs/agent-core": "^0.17.0",
15
15
  "dotenv": "^16.0.0"
16
16
  },
17
17
  "devDependencies": {
@@ -11,8 +11,8 @@
11
11
  "typecheck": "tsc --noEmit"
12
12
  },
13
13
  "dependencies": {
14
- "@backendkit-labs/agent-coding": "^0.16.0",
15
- "@backendkit-labs/agent-core": "^0.16.0",
14
+ "@backendkit-labs/agent-coding": "^0.17.0",
15
+ "@backendkit-labs/agent-core": "^0.17.0",
16
16
  "dotenv": "^16.0.0"
17
17
  },
18
18
  "devDependencies": {
@@ -11,7 +11,7 @@
11
11
  "typecheck": "tsc --noEmit"
12
12
  },
13
13
  "dependencies": {
14
- "@backendkit-labs/agent-core": "^0.16.0",
14
+ "@backendkit-labs/agent-core": "^0.17.0",
15
15
  "dotenv": "^16.0.0"
16
16
  },
17
17
  "devDependencies": {
@@ -12,7 +12,7 @@
12
12
  "typecheck": "tsc --noEmit"
13
13
  },
14
14
  "dependencies": {
15
- "@backendkit-labs/agent-core": "^0.16.0",
15
+ "@backendkit-labs/agent-core": "^0.17.0",
16
16
  "dotenv": "^16.0.0",
17
17
  "openai": "^4.0.0",
18
18
  "zod": "^3.25.0"
@@ -73,5 +73,6 @@ export function createEngine(transport: CallbackTransport): AgentEngine {
73
73
  maxContextMessages: 100,
74
74
  // Long-term memory — injects relevant context each turn
75
75
  memorySystem: memory,
76
+ additionalRoots: [APP_DIR],
76
77
  });
77
78
  }
@@ -12,7 +12,7 @@
12
12
  "typecheck": "tsc --noEmit"
13
13
  },
14
14
  "dependencies": {
15
- "@backendkit-labs/agent-core": "^0.16.0",
15
+ "@backendkit-labs/agent-core": "^0.17.0",
16
16
  "dotenv": "^16.0.0",
17
17
  "openai": "^4.0.0",
18
18
  "zod": "^3.25.0"
@@ -62,5 +62,6 @@ export function createEngine(transport: CallbackTransport): AgentEngine {
62
62
  historyPath: HISTORY,
63
63
  maxContextMessages: 100,
64
64
  memorySystem: memory,
65
+ additionalRoots: [APP_DIR],
65
66
  });
66
67
  }
@@ -12,7 +12,7 @@
12
12
  },
13
13
  "dependencies": {
14
14
  "@backendkit-labs/agent-coding": "^0.14.0",
15
- "@backendkit-labs/agent-core": "^0.16.0",
15
+ "@backendkit-labs/agent-core": "^0.17.0",
16
16
  "dotenv": "^16.0.0"
17
17
  },
18
18
  "devDependencies": {
@@ -11,7 +11,7 @@
11
11
  "typecheck": "tsc --noEmit"
12
12
  },
13
13
  "dependencies": {
14
- "@backendkit-labs/agent-core": "^0.16.0",
14
+ "@backendkit-labs/agent-core": "^0.17.0",
15
15
  "dotenv": "^16.0.0",
16
16
  "openai": "^4.0.0",
17
17
  "zod": "^3.25.0"
@@ -12,7 +12,7 @@
12
12
  "typecheck": "tsc --noEmit"
13
13
  },
14
14
  "dependencies": {
15
- "@backendkit-labs/agent-core": "^0.16.0",
15
+ "@backendkit-labs/agent-core": "^0.17.0",
16
16
  "@modelcontextprotocol/sdk": "^1.12.0",
17
17
  "dotenv": "^16.0.0",
18
18
  "zod": "^3.25.0"
@@ -11,7 +11,7 @@
11
11
  "typecheck": "tsc --noEmit"
12
12
  },
13
13
  "dependencies": {
14
- "@backendkit-labs/agent-core": "^0.16.0",
14
+ "@backendkit-labs/agent-core": "^0.17.0",
15
15
  "dotenv": "^16.0.0"
16
16
  },
17
17
  "devDependencies": {