Tools around the workspace

Server terminals

Open a terminal with the terminal button in the composer. It runs on the server, in the session's project folder. New terminal adds another shell as a separate tab. Leave the session or close the app and the shell keeps running; come back to the same live terminal. A server allows up to 32 open terminals.

Run command lists your project commands. Choose Manage commands to save one with a name, a description, and one or more lines that run from the project root. Write {{name}} in a line to be asked for that value when you run it.

Good to know · Closing a terminal or stopping the server ends its process. Settings → General → Command Shell chooses the bash shell agents use for their commands; on Windows, Git Bash is recommended.

Databases and SQL

Open the Database panel in a project with Ctrl+D (Cmd+D on a Mac). Connect to Postgres, MySQL, SQLite, or SQL Server with a connection string or field by field. Browse Tables, the Overview, and relationships under Rels, and write SQL under Query.

In the SQL editor, Ctrl+Enter runs the query, or only the selected text if you highlighted some, and Ctrl+Space shows suggestions; on a Mac, use Cmd in place of Ctrl. Connections and queries run from the server, so its network access and credentials decide what you can reach.

Good to know · The SQL editor runs exactly what you execute, including writes, without asking again. A connected database is a real system, not a disposable copy.

Find and switch sessions

Search sessions (Ctrl+K, or Cmd+K on a Mac) searches across all projects. Use the project filter to narrow it to one project. Before you type, it lists your Pinned and Recent sessions. Press Ctrl+P on a highlighted session to pin or unpin it.

To go back to a session you visited recently, hold Ctrl and tap Tab to move through Recent sessions in visit order, then release Ctrl to open the highlighted one. Add Shift to go backward, and press Esc to cancel. Ctrl+Tab uses Control on a Mac too. Some browsers keep Ctrl+Tab for their own tabs; use Ctrl+Alt+↓ and ↑ instead (Cmd+Option on a Mac).

Search projects at the top of the project sidebar by name or path. Zen mode (Ctrl+Alt+Z) hides every panel and control so only the session remains; press it again to bring them back. Your workspace across devices lists the main shortcuts, and Settings → Keyboard shortcuts lists all of them.

Import sessions from AI CLIs

Settings → Import from CLIs copies chats recorded by Claude Code, Codex, and GitHub Copilot CLI on the server's computer into Koyd projects, with their timeline, titles, and tool calls. Koyd only reads the CLI logs and never imports the same session twice.

1. Open Settings → Import from CLIs. Choose Scan again after new CLI work.
2. Filter by CLI or status, or search titles, prompts, and folders, and select the sessions you want.
3. Under Import into, keep the suggested project for each folder, pick another one, or create a new project.
4. Choose Import. Imported sessions are regular Koyd sessions, so you can open and continue them.

Good to know · Sessions that did not record a folder, or whose folder no longer exists on the server, need a project chosen by hand.

Providers and models

Settings → Providers lists every provider the bundled agent engine supports, including Anthropic, OpenAI, OpenAI Codex, GitHub Copilot, Google, Google Vertex AI, Amazon Bedrock, Azure OpenAI, OpenRouter, Mistral, xAI, DeepSeek, and Groq. Search the list and choose Connect to sign in or add a key. Under Custom providers, add your own endpoint that speaks OpenAI Chat Completions, OpenAI Responses, Anthropic Messages, or Google Generative AI.

OpenCode Go multi-key spreads requests across several OpenCode Go API keys. Choose Configure, paste your keys one per line (optionally as name: key), choose Add keys, then Enable. Load models in Settings → Models and pick OpenCode Go (Multi-key). It balances the number of requests per key, not exact token use. A key that hits a rate limit rests for a while, and a rejected key is set aside for ten minutes. The keys are stored unencrypted in the server's data directory.

Turn on the models you want in Settings → Models. Settings → General sets the default model and mode for new sessions, and the Assistant Model used for session names, commit messages, and other background tasks.

The Lab and slash commands

The Lab (Ctrl+Alt+L) holds the resources sessions reuse: Tools, Skills, MCP Servers, Modes, Prompts, Swarms, Agents, Memory, and Knowledge. Working with agents explains agents, modes, skills, and MCP servers.

Type / in the message box for commands. /prompt inserts a saved prompt template. /skills and /mcp switch skills and MCP servers for the session, and /tools switches session tools. /apps opens a saved app in the session, and /compact compacts the conversation to free up context.

Browser and computer use

The shared Chromium browser and optional computer use on the server's desktop are session tools you turn on with /tools. Setup, controls, screenshots, recordings, and limits are covered in Shared browser.

Settings belong to an instance

Settings has General, Keyboard shortcuts, Instances, Providers, Models, Teams, Import from CLIs, and Data. Provider connections, enabled models, Lab resources, and the theme apply to the instance you are connected to. Device credentials, drafts, and display preferences stay in the browser or app on each device. Koyd Dark is the default theme.