You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: .agent/skills/bos/SKILL.md
+17-25Lines changed: 17 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
name: bos
3
-
description: CLI alias for everything-dev Module Federation projects. Use when creating new BOS projects, publishing bos.config.json to the FastKV registry, syncing with remote configs (every.near/everything.dev), running development servers (`everything-dev dev` or `bos dev`), or building/deploying federated apps. Deploy → publish → sync workflow for shared configuration.
3
+
description: CLI alias for everything-dev Module Federation projects. Use when creating new BOS projects, publishing bos.config.json to the temporary dev.everything.near FastKV registry, syncing with remote configs (every.near/everything.dev), running development servers (`everything-dev dev` or `bos dev`), or building/deploying federated apps. Build/deploy → publish → sync workflow for shared configuration.
4
4
---
5
5
6
6
# everything-dev CLI (`bos` alias)
@@ -57,10 +57,10 @@ bos start --no-interactive # All remotes, production URLs
57
57
The core workflow for sharing configuration:
58
58
59
59
```bash
60
-
# 1. Deploy apps to Zephyr (updates bos.config.json with production URLs)
61
-
bos deploy
60
+
# 1. Build/deploy all workspaces when needed (updates bos.config.json with production URLs)
61
+
bos publish --deploy
62
62
63
-
# 2. Publish config to the FastKV registry
63
+
# 2. Publish config to the temporary FastKV registry
Build and deploy to Zephyr Cloud. Updates `bos.config.json` with production Zephyr URLs after successful deployment.
60
-
61
-
```bash
62
-
bos deploy # Deploy all
63
-
bos deploy ui # Deploy UI only
64
-
bos deploy --force # Force rebuild
65
-
```
66
-
67
-
Requires `ZE_SERVER_TOKEN` and `ZE_USER_EMAIL` in `.env.bos` for CI/CD.
59
+
`bos deploy` is not a standalone command in the current CLI. Use `bos publish --deploy` to build/deploy all workspaces and then publish the updated config.
68
60
69
61
### `bos publish`
70
62
71
-
Publish `bos.config.json` to the FastKV registry.
63
+
Publish `bos.config.json` to the temporary `dev.everything.near`FastKV registry.
72
64
73
65
```bash
74
-
bos publish # Mainnet
66
+
bos publish # Publish only
67
+
bos publish --deploy # Build/deploy all workspaces, then publish
75
68
bos publish --network testnet
76
69
bos publish --dry-run # Preview without sending
70
+
bos publish --packages ui,api
77
71
```
78
72
79
73
### `bos clean`
@@ -251,34 +245,14 @@ Process tracking uses `.bos/pids.json` to track spawned processes.
251
245
252
246
## Docker
253
247
254
-
### `bos docker build`
255
-
256
-
Build Docker image for production or development.
257
-
258
-
```bash
259
-
bos docker build # Production image (Dockerfile)
260
-
bos docker build --target development # Dev image (Dockerfile.dev)
261
-
bos docker build --tag my-tag # Custom tag
262
-
bos docker build --no-cache # Build without cache
263
-
```
264
-
265
-
### `bos docker run`
266
-
267
-
Run container with configurable modes.
248
+
Use the repo `Dockerfile` directly, or build the image in CI and push to GHCR.
268
249
269
250
```bash
270
-
bos docker run # Production mode
271
-
bos docker run --detach # Run in background
272
-
bos docker run --port 8080 # Custom port
273
-
bos docker run --target development --mode serve # Agent-ready (RPC exposed)
274
-
bos docker run --target development --mode dev # Full dev mode
275
-
bos docker run --env KEY=value # Pass env vars
251
+
docker build -t everything-dev .
252
+
docker run -p 3000:3000 everything-dev
276
253
```
277
254
278
-
**Modes:**
279
-
-`start` (default): Production mode, fetches config from the FastKV registry
280
-
-`serve`: Exposes CLI as RPC API at `/api/rpc` (agent-ready)
281
-
-`dev`: Full development mode with hot reload
255
+
The container uses `bun run start` and fetches config from the FastKV registry.
Fix published app discovery and FastKV publish flow so registry reads use the stored manifest data, publish can succeed after FastKV indexing, and the app explorer links directly to the FastKV config record.
0 commit comments