Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
17 changes: 11 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -384,7 +384,7 @@ dyro bootstrap --yes
dyro doctor
```

After setup, run `dyro`. The first run inside a project registers it in a reversible global home. From then on, the same command can resume a recent development line, hotfix, or existing task worktree from any directory—without remembering `--root`:
`dyro setup` registers the completed Profile in the reversible global home by default, so it is visible in Console immediately. The first registered workspace becomes the default; later setup runs keep the existing default unless you pass `--default`. Use `--no-register` for CI or temporary workspaces. From then on, bare `dyro` can resume a recent development line, hotfix, or existing task worktree from any directory—without remembering `--root`:

```bash
dyro
Expand All @@ -397,11 +397,16 @@ on the local machine are labeled `open workspace only` and receive no gate,
review, merge, or push authority. Explicit commands such as
`dyro open dev --agent codex` continue to launch directly for scripts.

The picker detects Cursor Desktop separately from Cursor CLI and supports
OpenClaw as a launch-only external runtime. Ready tools appear before tools that
need setup or installation; the current workspace's last choice, project
recommendation, personal default, and pinned order provide stable tie-breaking.
Selecting a missing supported tool opens a confirmation-first guided installer:
The picker detects Codex App and Claude Code Desktop separately from their
CLI counterparts, detects Cursor Desktop separately from Cursor CLI, supports
Antigravity CLI (`agy`) and Qoder CLI (`qodercli`) as launch-only terminal
tools, opens ZCode as a launch-only desktop tool, and supports OpenClaw as a
launch-only external runtime. It begins with at most three common choices;
type `m` for the full catalog or enter a tool ID, label, or command directly.
Ready tools appear before tools that need setup or installation; the current
workspace's last choice, project recommendation, personal default, and pinned
order provide stable tie-breaking. Selecting a missing supported tool opens a
confirmation-first guided installer:

```bash
dyro tool list
Expand Down
29 changes: 24 additions & 5 deletions docs/tool-catalog.md
Original file line number Diff line number Diff line change
Expand Up @@ -75,18 +75,37 @@ user can inspect and choose the platform-specific installer. This applies to
Cursor CLI and Hermes; Cursor Desktop likewise opens the official download
page.

Current catalog entries include Codex, Claude Code, Cursor Desktop, Cursor CLI,
Grok, OpenCode, OpenClaw, Hermes, Kimi Code, and Shell. An entry can be known
without having an audited installation recipe; such entries fail closed with
an actionable message.
Current catalog entries include Antigravity CLI, Codex CLI, Codex App, Claude
Code CLI, Claude Code Desktop, Cursor Desktop, Cursor CLI, Grok, OpenCode,
OpenClaw, Hermes, Kimi Code, Qoder CLI, ZCode, and Shell. Antigravity uses the
official `agy` command; Qoder uses `qodercli`; ZCode is opened as a desktop
workspace tool. An entry can be known without having an audited installation
recipe; such entries fail closed with an actionable message.

## Cursor Desktop and OpenClaw
## Compact Home picker

Home starts by showing at most three common choices: the most recent or
default tool, project recommendation, user pins, and available Dyro adapters.
This keeps everyday startup short while retaining the full catalog. Enter a
tool ID, label, or command directly, or type `m` to expand the full list,
including guided-install choices. The shorter display does not change launch
authority: launch-only tools still only open the selected workspace.

## Desktop apps and OpenClaw

Cursor Desktop is distinct from Cursor CLI. Dyro detects the `cursor` command,
the standard macOS application bundle, or the standard per-user Windows
application path, then opens the selected workspace as a launch-only desktop
tool.

Codex App and Claude Code Desktop are likewise separate from their terminal
tools. On macOS, Dyro detects their application bundles before offering them,
including the ChatGPT app's Codex entry and Claude Code's URL-handler bundle.
Codex uses `codex app <workspace>` when the CLI is available. Claude uses its
official Code deep link with the selected folder; Claude Desktop still asks the
user to confirm that folder before it is adopted. Neither desktop launch path
turns into a Dyro adapter.

OpenClaw is treated as an external runtime, not a Dyro adapter. A configured
installation receives the selected path through `OPENCLAW_WORKSPACE_DIR`. A
fresh installation starts official onboarding with that workspace and
Expand Down
Loading