Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
83 commits
Select commit Hold shift + click to select a range
9a84425
docs: claude's dw for implementation inspiration
Waishnav Jul 21, 2026
a7c95ec
docs: devspace plan
Waishnav Jul 21, 2026
2800b80
html response
Waishnav Jul 21, 2026
28f3e5b
feat(workflow): freeze public types and limits
Waishnav Jul 21, 2026
f01a96e
refactor(agents): rename thinking to effort
Waishnav Jul 21, 2026
5209347
docs(agents): document effort field and CLI flag
Waishnav Jul 21, 2026
0443586
feat(db): add workflow journal tables (v5)
Waishnav Jul 21, 2026
f39bc2c
feat(workflow): implement WorkflowStore journal API
Waishnav Jul 21, 2026
930e8b3
feat(workflow): add script parser and restricted sandbox
Waishnav Jul 21, 2026
775f7f0
feat(workflow): implement engine API with fakes
Waishnav Jul 21, 2026
d5ea59d
feat(workflow): add files, worktrees, replay, and schema
Waishnav Jul 21, 2026
d14d67c
feat(workflow): add CLI run/status/cancel/ls and worker
Waishnav Jul 21, 2026
c921419
feat(workflow): add dynamic-workflows skill and seed both defaults
Waishnav Jul 21, 2026
349b52c
feat(agents): add agentProviders config + init/doctor probe
Waishnav Jul 21, 2026
e1ec049
feat(workflow): register MCP run/status/cancel tools
Waishnav Jul 21, 2026
3030d86
feat(agents): pass schema as Codex turn outputSchema
Waishnav Jul 21, 2026
6af99da
feat(agents): Claude native outputFormat + structured_output
Waishnav Jul 21, 2026
7d797e3
feat(workflow): native-first schema for codex/claude agent()
Waishnav Jul 21, 2026
a8b8e5a
fix(workflow): make native schema fallback session-aware
Waishnav Jul 21, 2026
3343404
test(workflow): normalize persisted paths on windows
Waishnav Jul 21, 2026
4cb4007
refactor(workflow): strengthen contracts and zod boundaries
Waishnav Jul 21, 2026
d5b00f5
refactor(workflow): model operational failures with better-result
Waishnav Jul 21, 2026
f9a1dc7
feat(workflow): persist replay provenance
Waishnav Jul 25, 2026
c8f0b65
feat(workflow): add script iteration and call inspection
Waishnav Jul 25, 2026
058297b
docs(workflow): teach recovery without budget stub
Waishnav Jul 25, 2026
332aa8e
feat(workflow): query runs by workspace
Waishnav Jul 25, 2026
a499c2e
feat(workflow): project workflow read model
Waishnav Jul 25, 2026
5ee0022
feat(workflow): add read-only project TUI
Waishnav Jul 25, 2026
dbe26f7
feat(workflow): add UI snapshot projections
Waishnav Jul 25, 2026
d3643e8
feat(workflow): expose read-only app snapshots
Waishnav Jul 25, 2026
57296a6
feat(ui): recognize workflow result cards
Waishnav Jul 25, 2026
4bc9558
feat(ui): add live workspace and workflow dashboards
Waishnav Jul 25, 2026
4777bab
docs(ui): document read-only workflow dashboards
Waishnav Jul 25, 2026
f5e9252
feat(workflow): isolate script execution in child process
Waishnav Jul 26, 2026
09a7fc4
test(workflow): cover sandbox termination and escapes
Waishnav Jul 26, 2026
12cee07
fix(workflow): keep sandbox values in vm realm
Waishnav Jul 27, 2026
d4efd02
fix(workflow): harden sandbox process teardown
Waishnav Jul 27, 2026
a78357a
fix(workflow): journal terminal transitions atomically
Waishnav Jul 26, 2026
5528337
feat(workflow): add shared lifecycle supervisor
Waishnav Jul 26, 2026
e0b078a
fix(workflow): supervise cancellation and stale workers
Waishnav Jul 26, 2026
244d42e
fix(workflow): close stale reaper races
Waishnav Jul 27, 2026
0b52e5e
fix(workflow): bound MCP event pages
Waishnav Jul 27, 2026
ed623da
feat(workflow): persist exact replay values
Waishnav Jul 26, 2026
749ebb7
fix(workflow): replay only deterministic call prefixes
Waishnav Jul 26, 2026
4b0802f
docs(workflow): explain deterministic prefix replay
Waishnav Jul 26, 2026
8f30225
test(workflow): cover oversized structured results
Waishnav Jul 27, 2026
287cbce
refactor(agents): share profile prompt identity helpers
Waishnav Jul 26, 2026
550f776
feat(workflow): select configured agent profiles
Waishnav Jul 26, 2026
229f282
fix(workflow): honor nested workflow context
Waishnav Jul 26, 2026
7675c14
fix(workflow): confine project workflow scripts
Waishnav Jul 26, 2026
b9c78eb
fix(workflow): parse module syntax without raw scans
Waishnav Jul 26, 2026
323fe50
docs(workflow): teach profile selection and project scripts
Waishnav Jul 26, 2026
a23be1c
fix(workflow): preserve resume names and typed reads
Waishnav Jul 26, 2026
94ac40d
fix(workflow): parse metadata as pure literals
Waishnav Jul 27, 2026
3f01013
test(workflow): cover path and profile identity guards
Waishnav Jul 27, 2026
620b180
refactor(config): remove experimental provider persistence
Waishnav Jul 27, 2026
d640cf8
refactor(agents): share execution target resolution
Waishnav Jul 27, 2026
f2482bb
refactor(agents): describe provider model and effort capabilities
Waishnav Jul 27, 2026
321b81c
refactor(features): separate subagent and workflow capabilities
Waishnav Jul 27, 2026
69fee30
fix(workspace): expose only usable agent capabilities
Waishnav Jul 27, 2026
f25d8e9
refactor(skills): replace subagent delegation guidance
Waishnav Jul 27, 2026
2f17478
docs(skills): add provider-specific override references
Waishnav Jul 27, 2026
f214c19
fix(skills): keep bundled agent skills package-managed
Waishnav Jul 27, 2026
1ace1f0
refactor(workflow): name live provider availability accurately
Waishnav Jul 27, 2026
5c1ddea
docs(agents): document experimental capability boundaries
Waishnav Jul 27, 2026
691998e
test(workflow): follow provider availability rename
Waishnav Jul 27, 2026
5bf5374
docs(config): describe effective agent capability gates
Waishnav Jul 27, 2026
562e54a
feat(agents): discover usable delegation targets
Waishnav Jul 27, 2026
b347a82
feat(workflow): merge dw-16 agent/subagent overhaul (#118)
Waishnav Jul 27, 2026
b677c3e
feat(workflow): merge dw-15 profiles and project workflows (#117)
Waishnav Jul 27, 2026
8ce8274
Merge pull request #116 from pr/dw-14-prefix-replay-integrity
Waishnav Jul 27, 2026
0b0f5e2
Merge pull request #115 from pr/dw-13-workflow-lifecycle-supervisor
Waishnav Jul 27, 2026
e3ffd22
Merge pull request #114 from pr/dw-12-sandbox-process-boundary
Waishnav Jul 27, 2026
0328090
Merge pull request #112 from pr/dw-11-workflow-mcp-ui
Waishnav Jul 27, 2026
6b449e6
Merge pull request #111 from pr/dw-10-workflow-tui
Waishnav Jul 27, 2026
1a6764d
Merge pull request #108 from pr/dw-9-resume-iteration-inspection
Waishnav Jul 27, 2026
1e21ad1
Merge pull request #101 from pr/dw-8-result-errors
Waishnav Jul 27, 2026
d052520
Merge pull request #100 from pr/dw-7-typed-contracts-zod
Waishnav Jul 27, 2026
7304a6a
Merge pull request #99 from pr/dw-6-native-schema
Waishnav Jul 27, 2026
171d43f
Merge pull request #98 from pr/dw-5-mcp-skill
Waishnav Jul 27, 2026
a28337e
Merge pull request #97 from pr/dw-4-cli-worker
Waishnav Jul 27, 2026
73ef5fe
Merge pull request #96 from pr/dw-3-engine
Waishnav Jul 27, 2026
0e30254
Merge pull request #95 from pr/dw-2-store-sandbox
Waishnav Jul 27, 2026
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions docs/agent-profile-schema.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ name: reviewer
description: Read-only reviewer for bugs, security risks, and missing tests.
provider: codex
model: gpt-5.4
thinking: high
effort: high
disabled: false
---

Expand Down Expand Up @@ -87,26 +87,28 @@ model: gpt-5.4
model: sonnet
```

### `thinking`
### `effort`

Optional provider reasoning effort, thinking level, or model variant. If omitted,
DevSpace lets the provider default apply. Values are provider-specific
passthrough strings; DevSpace does not translate names between harnesses.

```yaml
thinking: low
thinking: high
thinking: xhigh
effort: low
effort: high
effort: xhigh
```

DevSpace passes this through to providers that expose a matching control:

- `claude`: SDK effort with adaptive thinking.
- `codex`: SDK model reasoning effort.
- `pi`: `--thinking`.
- `pi`: CLI `--thinking` (provider-native flag; DevSpace field is still `effort`).
- `opencode`: model variant.
- `cursor` and `copilot`: ACP thought-level config when supported.

Legacy profile frontmatter key `thinking:` is still accepted and maps to `effort`.

### `disabled`

Optional boolean. Disabled profiles are not exposed.
Expand Down Expand Up @@ -145,7 +147,7 @@ devspace agents show <id>
"description": "Read-only reviewer for bugs, security risks, and missing tests.",
"provider": "codex",
"model": "gpt-5.4",
"thinking": "high"
"effort": "high"
}
```

Expand Down
36 changes: 26 additions & 10 deletions docs/chatgpt-coding-workflow.md
Original file line number Diff line number Diff line change
Expand Up @@ -85,16 +85,17 @@ DevSpace discovers standard Agent Skills from:
- project `.agents/skills`
- `~/.devspace/skills`

It also keeps compatibility with:
It also includes:

- the bundled `subagent-delegation` skill when `DEVSPACE_SUBAGENTS=1`, unless `~/.devspace/skills/subagent-delegation/SKILL.md` exists
- the package-managed `subagents` skill when the Subagents capability is enabled
- the package-managed `dynamic-workflows` skill when the Dynamic Workflows capability is enabled
- `DEVSPACE_AGENT_DIR/skills`, defaulting to `~/.codex/skills`
- additional paths from `DEVSPACE_SKILL_PATHS`

When Subagents are enabled, DevSpace discovers agent profiles
from `~/.devspace/agents/*.md` and project `.devspace/agents/*.md`.
`open_workspace` exposes a compact catalog with profile names, descriptions,
providers, and optional models/thinking levels so the model can choose a configured agent
providers, and optional models/effort levels so the model can choose a configured agent
without seeing provider-specific launch details.

Example profiles are packaged under `examples/agents/` for users who want
Expand All @@ -113,10 +114,15 @@ Skill paths may be outside the workspace. DevSpace only permits reading:

Set `DEVSPACE_SKILLS=0` to hide skills from workspace output. Set
`DEVSPACE_SUBAGENTS=1` to expose the experimental subagent catalog and
`subagent-delegation` skill. That skill teaches the minimal
`devspace agents ls`, `devspace agents run`, and `devspace agents show`
workflow. The catalog comes from `open_workspace`; `devspace agents ls` lists
existing subagent sessions for that workspace.
`subagents` skill. That skill can use target information already supplied by the
host or discover it with `devspace agents targets`. `devspace agents ls` lists
existing subagent sessions for the current workspace.

Set `DEVSPACE_WORKFLOWS=1` to enable Dynamic Workflows independently. When the
variable is omitted, Dynamic Workflows follows the effective Subagents setting,
including persisted config and any environment override. Disabled features are
omitted from the `open_workspace` schema and response rather than returned as
empty capability arrays.

## Tool Names

Expand Down Expand Up @@ -148,12 +154,22 @@ registered. `exec_command` returns a process session ID when a command is still
running after its yield window. Use `write_stdin` to poll it, send input, resize
a PTY, or send Ctrl-C. Set `tty: true` only for commands that need a terminal.

## Show Changes
## Widget UI and Show Changes

By default, `DEVSPACE_WIDGETS=full`.

In that mode, DevSpace attaches widget UI to the exposed workspace, file, edit,
and shell tools. The aggregate `show_changes` tool is not exposed by default.
In that mode, DevSpace attaches widget UI to the exposed workspace, workflow,
file, edit, and shell tools. The `open_workspace` dropdown presents the opened
root, loaded skills and instructions, available agent providers/profiles, and
currently active workflows for that workspace.

Dynamic Workflow views are read-only. They refresh through app-only MCP tools
and show observed phases, agent calls, replay state, worktree isolation, errors,
and recent activity. When the host supports MCP Apps fullscreen display mode,
the card offers an **Open dashboard** presentation control. It does not add
cancel, resume, apply, or cleanup actions.

The aggregate `show_changes` tool is not exposed by default.

Use `DEVSPACE_WIDGETS=off` to disable widget UI, or `DEVSPACE_WIDGETS=changes`
to expose the aggregate show-changes flow.
Expand Down
Loading