Your workspace across devices

Where everything runs

• Koyd Server runs agents, queues, swarms, workflows, files, Git, terminals, databases, memory, browser automation, and app backends.
• The Koyd app, in a browser tab or installed on a device, shows the workspace and keeps your drafts, display preferences, and that device's access to each server.
• A release bundles the server, its Node runtime, the app, and the local memory model, so the server and app update together.
• The koyd.app website provides documentation, installers, and update information. It does not relay your sessions. Its optional Wi-Fi setup page only helps a new device trust your server's certificate.

Run a server on your laptop, a workstation, or a machine with its own domain. Switching devices changes how you reach that server; it does not move your files or sync separate servers.

Connect and switch instances

Each server has its own identity, data, settings, and paired devices. Settings → Instances lists them under Your servers with their status: Connected, Connecting, Offline, or Pair again. Select one to switch this window to it. Switching does not stop agents on the other server.

In a desktop browser or installed desktop app, the new-window button next to a server opens it in its own window. That window stays on that server across reloads, so you can work on two servers side by side. Phones, tablets, and narrow windows switch in place.

Good to know · Projects, provider keys, and settings are not synced between servers. Give each server a recognizable name so you know which computer a command will affect. Server setup and operations explains how to add servers and pair devices.

The desktop workspace

The workspace shows your projects and sessions, the conversation and composer, and the panels you open for the current task, such as Changes, Codemaps, Database, Swarm, Lab, Apps, and Browser. Settings → Keyboard shortcuts lists every shortcut. On a Mac, use Cmd and Option in place of Ctrl and Alt, except for Ctrl+Tab.

Ctrl+Alt+N

New session

Ctrl+K

Search sessions

Ctrl+Tab

Next recently visited session

Ctrl+B

Toggle sidebars

Ctrl+Alt+Z

Toggle Zen mode

Ctrl+,

Toggle Settings

Each device remembers its own selected project and session, and sessions that are working stay above idle ones in the sidebar. Koyd Dark is the default theme. Change it in Settings → General → Theme; the choice is saved for the server you are connected to.

On a phone

On a phone, Koyd uses a mobile layout. The header shows the current project and conversation, and a bar at the bottom has four buttons:

• Sessions or Chat switches between the session list and the conversation.
• New starts a session.
• Search finds sessions across your projects.
• Tools opens a sheet of workspace tools such as Changes, Codemaps, Database, Swarm, Lab, and Apps. Swipe down on its handle, or tap outside it, to close it.

The composer stays above the on-screen keyboard, and Done closes the keyboard. Your draft survives panel changes and rotation. Tool panels use the full width of the screen.

Review notifications on this device

Koyd can notify a device when a workflow is waiting for your review, even when the app is closed. Turn it on once per device with Turn on notifications in the Workflows view, or with the bell in the Workflows toolbar. Tapping a notification opens that review. The bell menu also has Send a test notification. See Workflows for how reviews work.

• iPhone and iPad need iOS 16.4 or later, with Koyd added to the Home Screen and opened from there. Koyd shows these steps when they are needed.
• Android phones and computers work with current Chrome, Edge, Firefox, or Safari. Allow notifications when the browser asks.
• Notifications travel through the browser's push service (Google, Apple, or Mozilla), so the server computer needs internet access. Each message is encrypted end to end and contains the workflow name, step title, first line of the review message, and project name.
• A device gets notifications from the server that was active when you turned them on. If you use several servers, turn them on from the one whose reviews you want.
• To stop them, choose Turn off on this device in the bell menu, or block notifications for Koyd in the browser's site settings.

Your Koyd Apps on each device

Koyd Apps live on the server, like your projects. Switching servers switches the app library and its data, and server-backed apps need a live connection to their server. Koyd Apps explains how apps open on desktop and mobile.

Offline, drafts, and reconnects

The installed app caches its own files, so it can open offline and show the connection status. Server features need a connection. Unsent drafts stay on the device. When you reconnect, Koyd loads the server's current state and transcript.

A short drop does not cancel work. Commands you send while reconnecting wait in a queue, and an unanswered command is re-sent under the same ID, so the server returns the result it already produced instead of running it twice. On a congested link, Koyd skips live updates and refreshes from a snapshot rather than disconnecting.

Closing a tab or the app does not stop server work. Stopping or restarting the server ends active agents, terminals, and browser sessions; saved data and pairings stay. During an update restart, the app says so and reconnects by itself. See Updating Koyd.