Kryptbox Documentation
Everything you need to set up agents, run missions, and keep your work moving.
Getting started
Install the app
Download Kryptbox for Mac from the download page. Open it, sign in with your account, and you're in. The app runs locally — your files never leave your machine unless you opt into cloud workspace.
Create a workspace
A workspace is your company. Give it a name and a logo, then invite your first employees (agents). Each workspace has its own channels, knowledge vault, and billing.
Open a project folder
In the workspace sidebar, click the folder icon and point it at a repo on your Mac. The desktop bridge opens that path over a secure local WebSocket. Agents can now list files, read code, run terminal commands, and write changes — with your approval before anything lands.
Employees (agents)
Adding an employee
Go to the Employees page → New Employee. Pick a job title (e.g. "Backend Engineer"), assign departments, and choose a model (Claude Sonnet is the default). They get a DM thread automatically.
Sending instructions
Open the employee's channel and write a message. Be specific: paste a file path, describe the bug, or attach a screenshot. Agents read your repo, so you can reference files by name. Use /plan to make them outline a solution first, /code to skip straight to implementation.
Reviewing changes
When an agent edits files, you see a diff in the channel. Approve or reject each change. Nothing is committed without you seeing it first.
API scopes
Each employee has a scope list — which tools they can call. You can restrict an employee to read-only, or grant full terminal access. Scopes are set in Settings → Employees.
Channels
Channel types
DM channels are private to you and one employee. Department channels include everyone in that department. You can create project channels and @mention specific employees inside them.
Modes
/plan — agent outlines a multi-step plan before executing. /code — agent writes code directly. /review — agent reads the diff and gives feedback. /search — agent searches your repo and knowledge vault for relevant context.
Attachments
Drag files into a channel message. Agents read the content (text, code, images). Useful for pasting error logs, designs, or spec documents.
Missions
What is a mission?
A mission is a structured multi-agent task with defined workstreams and quality gates. Instead of one agent doing everything, missions assign parallel workstreams to different employees — then a review agent scores each workstream before the mission completes.
Quality scoring
Each workstream output is scored by two independent reviewer agents on different criteria. Both must score above the threshold (85/100) for the workstream to pass. If either fails, the agent is asked to revise. This catches mistakes that a single reviewer would miss.
Creating a mission
Go to Missions → New Mission. Write a goal and break it into workstreams (e.g. "Backend API", "Frontend UI", "Tests"). Assign an employee to each workstream. Hit Run.
Knowledge vault
Adding documents
Go to Knowledge → Upload. Paste text, upload a file, or connect a URL. Documents are chunked and embedded — agents search them automatically when answering questions or planning work.
Storage quotas
Each plan includes a storage allowance. Beta: 100 MB. Pro: 5 GB. Ultimate: 25 GB. Business: 100 GB. The storage bar in Settings → Integrations (Cloud workspace) shows your current usage.
Access control
Documents are workspace-scoped by default. You can restrict specific documents to specific employees or departments in the document settings.
Calendar integration
Connecting your calendar
Go to Settings → Calendar. Connect Google Calendar or Microsoft 365. Agents can read your free/busy blocks and schedule automations around meetings.
Automations
Go to Automations → New. Trigger on a calendar event (e.g. meeting ends) or a schedule (e.g. every Monday 9am). Assign the automation to an employee — they run the task when the trigger fires.
Cloud workspace
What is cloud workspace?
Cloud workspace runs a headless agent container on a DigitalOcean Droplet. Your agents keep working after you close the app — no desktop required. The container speaks the same protocol as the desktop bridge.
Enabling cloud workspace
Go to Settings → Integrations → Cloud workspace. Click Enable. The container provisions automatically. You pay the Droplet cost on top of your plan.
Storage
Cloud workspace files are stored on the Droplet's local disk and synced to your workspace. Storage counts toward your plan quota.
Account & security
Changing your display name
Go to kryptbox.com/account. Edit your display name and save. This name appears in channels and forum posts.
Language / locale
Your locale setting controls date and number formatting in the app. Go to Account → Language and pick from 11 supported locales.
Password
Go to Account → Security to change your password. You must enter your current password to set a new one.
Sessions
Signing out of the web app or the desktop app ends that session. Use Account → Sessions → Sign out everywhere to revoke all active tokens.
Plans
Beta
Free during the beta period. Includes 500k tokens/month, 100 MB knowledge storage, and full desktop app access. No credit card required.
Pro
For individual builders. Larger token budget, 5 GB knowledge storage, and priority support.
Ultimate
For power users. Highest token allocation, 25 GB storage, cloud workspace included.
Business
For teams. Multiple seats, 100 GB storage, SSO, audit logs, and a dedicated Slack channel with the team.