How to use Koyd

• Getting started

  Install Koyd Server on the computer with your projects, connect your browser, add a model provider, and send your first prompt.

  • Install the server
  • Connect a model
  • Choose a project
  • Send the first prompt
  • Install the app on your devices
  • Use another device on your network
  • Come back to your work

• Server setup and operations

  Run your own Koyd Server: everyday commands, the local HTTPS address, pairing, Wi-Fi sharing, remote access, backups, and removal.

  • Everyday commands
  • A friendly local address
  • Save configuration
  • Company computers and networks
  • Pair devices
  • Review and remove access
  • Connect over Wi-Fi
  • Sharing, restarts, and connection help
  • Use koyd.internal on other devices
  • Access outside your local network
  • Connect several instances
  • Service managers and portable packages
  • Backups and moving a server
  • Remove Koyd
  • When something does not connect

• Working with agents

  Run parallel sessions in one checkout, coordinate edits with file locks, delegate work to saved agents, and answer their questions.

  • Parallel sessions
  • File locks
  • Queue and chain prompts
  • Choose a mode
  • Set up Koyd from chat
  • Session tools
  • Answer agent questions
  • Delegate to agents
  • Agent queues and limits
  • Save reusable agents
  • Skills and MCP servers
  • Attach files
  • Token usage and completion sounds

• Swarm

  Give a coordinated team one goal, follow its tasks and reviews in mission control, and set the limits that keep each run bounded.

  • From goal to coordinated work
  • Follow the run
  • Keep responsibilities clear
  • Set limits
  • How a run finishes
  • Start with Forge
  • Handle interruptions
  • Swarm or workflow

• Workflows

  Define AI steps, commands, and reviews once, then run them the same way from Koyd, the command line, a schedule, or your own app.

  • What a workflow is
  • Build a workflow
  • Steps and their settings
  • Where workflows are saved
  • Workflows as YAML
  • Run a workflow
  • Run from the command line
  • Run on a schedule
  • Own branch or project folder
  • Reviews and approvals
  • Built-in steps
  • Create workflows from chat
  • Your own app: Workflow API and SDK
  • Reliability and limits

• Code maps, memory, and context

  Map how a feature works with links into the code, keep those links current as code changes, and let agents remember project facts between sessions.

  • Code maps
  • Outdated code links
  • Changes in a map
  • Project memory
  • Files and attachments

• Knowledge bases

  Import your own files and web pages into local knowledge bases that chats, projects, and workflow steps can search and cite.

  • Knowledge bases and memory
  • Create a knowledge base
  • Add web pages
  • Use knowledge in projects, chats, and workflows
  • Answers with sources
  • Let an agent add documents
  • AI ranking
  • Keep documents current
  • Limits

• Reviewing agent work

  Read each turn's reply and file changes, review every change in a session, and split the work into clear commits before you ship it.

  • Read the whole turn
  • Changes from a turn
  • Review every turn in a session
  • Read a diff
  • Review the checkout
  • Organize commits
  • Read and export results
  • Verify the outcome

• Shared browser

  Watch agents use a real Chromium browser on your Koyd Server, take control when they need you, and review their screenshots and recordings.

  • One browser for you and your agents
  • Set up the browser
  • Let a session use the browser
  • Watch, take control, and hand back
  • Share one of your tabs
  • Separate sign-ins in every tab
  • When the agent needs you
  • It behaves like a regular browser
  • Send page context to a chat
  • Screenshots and recordings
  • Tabs, limits, and cleanup
  • Optional computer use on the server’s desktop
  • What Koyd keeps and logs

• Koyd Apps

  Turn an idea into a saved tool with its own interface, data, optional server backend, and private AI, then use its tools in your sessions.

  • What a Koyd app is
  • Create an app
  • Open your saved apps
  • Start, stop, and inspect
  • Use app tools in sessions
  • Models, agents, and resources for app AI
  • Edit, import, and share
  • App styling and themes
  • Client and backend APIs
  • Client-only apps
  • Data and trust

• Tools around the workspace

  Use server terminals, databases, session search, CLI imports, provider settings, and the Lab alongside the agents in your Koyd workspace.

  • Server terminals
  • Databases and SQL
  • Find and switch sessions
  • Import sessions from AI CLIs
  • Providers and models
  • The Lab and slash commands
  • Browser and computer use
  • Settings belong to an instance

• Your workspace across devices

  One Koyd app connects your computers, tablet, and phone to independent servers, while agents and files stay on the server you choose.

  • Where everything runs
  • Connect and switch instances
  • The desktop workspace
  • On a phone
  • Review notifications on this device
  • Your Koyd Apps on each device
  • Offline, drafts, and reconnects

• Teams (beta)

  Use Koyd Teams to pay for AI providers together, share reviewed skills, agents, and MCP servers, and set spending limits, with storage your team owns.

  • What Teams does
  • Storage your team owns
  • Roles
  • Create a team
  • Invite and join
  • Team providers and cost modes
  • Budgets and limits
  • Allowed models and team-only providers
  • Know who pays
  • Share reviewed resources
  • Spending, sync, and offline use
  • Limits to know

• Updating Koyd

  Update Koyd Server and its app from the workspace, review release notes before the restart, and recover safely if an update fails.

  • Update from the app
  • What is checked
  • Where one-click updates are available
  • Manual update
  • If an update needs attention
  • Disk space and retained versions

Something missing or unclear? Write to support@koyd.app with the page and the detail that needs attention.