Dyadic Terminal

Install The Preview

Terminal is currently a private preview. Use a provided build from your Dyadic repository or build from source; there is no public installer feed yet. Windows x64 and Linux x64/glibc have native test receipts. The macOS ARM64 build still needs native acceptance.

Download the matching executable and its checksums.json from the same build. Compare SHA-256 before running it. Put it in a folder on your PATH as dyadic.exe on Windows or dyadic on Linux. The standalone build includes its runtime and parser assets.

Get-FileHash .\dyadic-windows-x64.exe -Algorithm SHA256
.\dyadic-windows-x64.exe doctor --json

cd terminal
bun install --frozen-lockfile
bun run check
bun tools/build.ts

Source builds currently use Bun 1.4.4. Select the executable under terminal/dist/ for your platform. To start an existing desktop installation on Windows:

& "$env:LOCALAPPDATA\Dyadic\Terminal\dyadic.cmd"

In Windows Command Prompt, including a default Windows SSH session in Termius, use "%LOCALAPPDATA%\Dyadic\Terminal\dyadic.cmd". Type powershell there to switch shells. If that SSH logon cannot unlock the credential store, append auth login --ephemeral and approve the displayed browser code for this session.

Sign In

dyadic auth login
dyadic tui

Open F5 Settings → Sign In inside Terminal and choose This Session Only or Save On This Device. Open the browser address shown, enter the short code and review its requested access. Approval uses your normal Dyadic sign-in and passkey. Web Settings → Connected Terminals shows authorizations and revocation; Computers opens the separate runner pairing controls.

Saved credentials use the OS credential store. When it is unavailable, choose This Session Only or run dyadic tui --ephemeral for temporary in-process access. Session-only access stays in that process, so quitting requires sign-in again; it does not erase a saved desktop credential. Credentials are never silently saved in plaintext. Workspace sign-in is separate from developer API keys and runner keys.

For persistent Windows SSH access, choose Save For Windows SSH or run dyadic auth login --credential-store windows-dpapi once, then start dyadic normally. This optional adapter requires installed Git Credential Manager and encrypts credentials for the Windows account using DPAPI. It probes storage before asking for browser approval, changes no global Git settings, and retains the same server expiry and revocation. Keep using the same Windows account and profile. Native Termius acceptance remains separate from the Windows encrypted-store test.

Connected Terminals shows each authorization's grant expiry and the client's declared storage choice. Older clients show storage as unknown. This list does not establish that a terminal is online, and a session-only client's exit does not notify the server to revoke its grant. Access tokens still expire after ten minutes; refresh credentials cannot outlive the thirty-day grant.

Use profiles for separate accounts or servers. Run dyadic profiles --help for supported profile commands and dyadic doctor --json for build and environment information.

Find Your Way

Enter sends a message. Ctrl+J inserts a newline. Pasting never submits automatically. Long pastes fold to keep the composer usable; /draft-edit opens a local editor. Your draft survives navigation and incoming activity.

Informational warnings appear under Notices. Expand the row or use /notices to read the original text. “Native checks not recorded” means there is no passing native check attached to the retained file version; saving or downloading a file does not establish a test result. Errors and waiting approvals remain visible.

Cloud And Your Computer

Dyadic Cloud is the hosted Workspace. A connected computer is your own machine running a paired Dyadic Runner. The Terminal app is a client; opening it does not itself give Iris access to your shell or Docker.

Use /target to choose a requested execution destination and /computers pair for browser pairing instructions. Check each action's recorded computer, folder and command. Computer availability, project scope, plugin switches and approvals still apply.

For example, ask Iris to “write a web server and deploy it with Docker on my paired computer.” Available skills can guide that work and machine tools can build or start Docker through the runner. A selected destination is a request, not evidence that deployment happened. Inspect the command results and service checks.

Skills, Plugins And References

Use @ to choose an enabled skill or plugin, and # to choose a chat, project or library. You can also use /mention and /reference. Reference previews use the same server context selection as the browser. Requested context and recorded inclusion remain different.

Manage installation and account switches in the existing Store. A mention does not install a package or grant new tool permissions. Skills are instructions and resources; plugins expose tool families. Supporting resources for independent delegated tasks remain subject to the current resource-access limitation.

Local Files And Data

dyadic view notes.md
dyadic view research.csv
dyadic view research.csv --aggregate value --json

Local viewing works offline. CSV/JSON tables support columns, sorting, filters, grouping, aggregates, selected-row export and charts. Exact values and source identities remain in the table and inspector; chart positions are approximate. Nulls, sampling, missing evidence and unknown costs are labeled.

Troubleshooting

• Old appearance: quit with Ctrl+Q and start the installed launcher again. An already-running executable stays on its original build.
• Missing choices or permissions: refresh, check the account's published models and terminal scopes, then inspect the specific server error.
• Clipboard unavailable: use the host terminal's paste shortcut or export the selected object. Model output never changes your clipboard automatically.
• Small or limited terminals: use dyadic plain, --ascii, --no-color or --reduced-motion. NO_COLOR is respected. Native screen-reader acceptance remains open.
• A disconnected run is not automatically replayed. Inspect its recorded state; an uncertain mutation receipt is not permission to submit the action again.

CLI Command Reference

Generated from the shared command registry. CLI and TUI use the same server owners. ask creates a new chat unless --chat is supplied. Piped input is read only with --stdin. Ctrl+C detaches from runs watch; for ask it requests cancellation and reports the observed result.

Use --json or --jsonl for versioned machine output. Exit codes: 0 success, 1 failure, 3 action needed, 4 authentication/scope denied, 5 conflict. Shell completions: dyadic completion powershell, bash or zsh.