dimcode 0.0.17-beta.5 → 0.0.17-beta.6
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 +49 -0
- package/dist/cli.mjs +805 -802
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -233,6 +233,55 @@ Inside the app, `/codexlogin` opens the same login flow.
|
|
|
233
233
|
|
|
234
234
|
Settings and local session data are stored in `~/.dimcode/dimcode/` by default.
|
|
235
235
|
|
|
236
|
+
### Active Session Runtime
|
|
237
|
+
|
|
238
|
+
Dimcode also publishes a small runtime record that external tools can read for live context handoff (for example voice input tools, desktop automations, or editor helpers).
|
|
239
|
+
|
|
240
|
+
By default the files live under:
|
|
241
|
+
|
|
242
|
+
```text
|
|
243
|
+
~/.dimcode/dimcode/runtime/
|
|
244
|
+
```
|
|
245
|
+
|
|
246
|
+
The main files are:
|
|
247
|
+
|
|
248
|
+
- `active-session.json` - the single live runtime record for the current Dimcode context
|
|
249
|
+
|
|
250
|
+
The runtime record includes fields such as:
|
|
251
|
+
|
|
252
|
+
- `sessionId`
|
|
253
|
+
- `cwd`
|
|
254
|
+
- `title`
|
|
255
|
+
- `mode`
|
|
256
|
+
- `providerId`
|
|
257
|
+
- `providerName`
|
|
258
|
+
- `modelId`
|
|
259
|
+
- `focused`
|
|
260
|
+
- `visibility`
|
|
261
|
+
- `updatedAt`
|
|
262
|
+
|
|
263
|
+
The file is updated in-place as focus changes:
|
|
264
|
+
|
|
265
|
+
- `focused` - Dimcode is the active terminal and the record contains the current chat session
|
|
266
|
+
- `blurred` / `suspended` - Dimcode keeps the last session context, but it is not the active terminal
|
|
267
|
+
- `inactive` - no chat session should be treated as active (for example on the home page)
|
|
268
|
+
|
|
269
|
+
Current behavior:
|
|
270
|
+
|
|
271
|
+
- Home screen clears the active session record so external tools do not pick up stale chat context
|
|
272
|
+
- Chat screen publishes the current session and workspace
|
|
273
|
+
- Terminal focus reporting is used when the terminal emulator supports xterm focus events
|
|
274
|
+
- Suspend / resume (`Ctrl+Z` / `fg`) also updates visibility
|
|
275
|
+
|
|
276
|
+
Dimcode also mirrors the core active context into process env for child-process integrations:
|
|
277
|
+
|
|
278
|
+
- `DIMCODE_ACTIVE_SESSION_ID`
|
|
279
|
+
- `DIMCODE_ACTIVE_SESSION_FOLDER`
|
|
280
|
+
- `GOATCHAIN_ACTIVE_SESSION_ID`
|
|
281
|
+
- `GOATCHAIN_ACTIVE_SESSION_FOLDER`
|
|
282
|
+
|
|
283
|
+
These env vars are best for Dimcode-spawned tools and hooks. For cross-app integrations, prefer reading the runtime JSON files.
|
|
284
|
+
|
|
236
285
|
### Skills Directory
|
|
237
286
|
|
|
238
287
|
Dimcode automatically discovers skills from both global and project-local directories:
|