# Cabinet Public Docs Cabinet is a local-first knowledge base and AI team workspace. This site is generated from a Cabinet folder. ## Pages - [Welcome to Cabinet](https://runcabinet.com/): Welcome to Cabinet Your Knowledge Base, your AI Team. Local first. Markdown backed. Yours. Cabinet collapses your notes, files, tasks, and AI agents into one folder on your compute... - [What is a Cabinet?](https://runcabinet.com/cabinet/): What is a Cabinet? A cabinet is a folder on your computer + an app for working with it . The folder holds your knowledge. The app gives you three ways to work with it. Open Cabinet... - [Agents](https://runcabinet.com/cabinet/agents/): Your AI team A Cabinet agent is a markdown file with a heartbeat . The file lives at .agents/<slug>/persona.md . Edit it, and the agent updates. Delete it, and the agent disa... - [Bring your own AI](https://runcabinet.com/cabinet/agents/byoai/): Bring your own AI Cabinet doesn't host inference. You connect the providers you already pay for , and Cabinet routes your agents' calls to them. There's no Cabinet middleman, no in... - [Conversations & approvals](https://runcabinet.com/cabinet/agents/conversations-and-approvals/): Conversations & approvals Cabinet's safety story is one rule: no agent acts on another agent's behalf without your approval. When a lead decides the researcher should brief a compe... - [Heartbeats](https://runcabinet.com/cabinet/agents/heartbeats/): Heartbeats A heartbeat is the difference between an assistant you have to summon and a teammate who shows up. It's a cron scheduled prompt attached to a persona. Every weekday at 9... - [Org chart & departments](https://runcabinet.com/cabinet/agents/org-chart-and-departments/): Org chart & departments A Cabinet team is a tree. Departments are folders, leads sit at the top, specialists sit underneath. Leads can dispatch work down. Specialists do focused wo... - [Persona](https://runcabinet.com/cabinet/agents/persona/): Persona A persona is the file that is your agent. Edit it, the agent updates. Delete it, the agent disappears. Git tracks every change. The whole agent — name, model, schedule, sys... - [Routines](https://runcabinet.com/cabinet/agents/routines/): Routines A routine is a task that runs on a schedule . Same prompt, same agent, same output shape, every Friday at 5pm. While heartbeats decide what to do at a moment, routines do... - [Skills](https://runcabinet.com/cabinet/agents/skills/): Skills A skill is a reusable bundle of instructions and helper scripts an agent can pull in for a task. Each skill is a folder with a SKILL.md on top and any assets, scripts, or sc... - [Tasks](https://runcabinet.com/cabinet/agents/tasks/): Tasks A task is the smallest unit of work in Cabinet. One prompt, one agent, one run, one output. Tasks are the thing routines schedule, agents dispatch, and you create from the ka... - [Data](https://runcabinet.com/cabinet/data/): Data The Data tab is your file tree . Whatever lives in your cabinet folder shows up here, in the same order, with first class viewers for the formats you already use. What you can... - [Markdown editor](https://runcabinet.com/cabinet/data/editor/): Markdown editor Cabinet's editor is Notion grade WYSIWYG on top of plain markdown . Everything you type roundtrips to a file on disk. Open the source toggle in the top right of any... - [Callouts, math & color](https://runcabinet.com/cabinet/data/editor/callouts-math-and-color/): Callouts, math & color The advanced group of slash commands plus the Cabinet highlight palette. Use them to make pages skimmable. Callouts Type /Callout for an info block or /Warni... - [Links & mentions](https://runcabinet.com/cabinet/data/editor/links-and-mentions/): Links & mentions Cabinet has three link surfaces : standard markdown links, wiki links, and @ mentions for AI context. Standard markdown links Type label or paste any URL with text... - [Media & embeds](https://runcabinet.com/cabinet/data/editor/media-and-embeds/): Media & embeds Cabinet handles images, videos, and dozens of URL based embeds as first class blocks in the editor . Everything saves next to the page on disk, except embeds — which... - [Slash commands](https://runcabinet.com/cabinet/data/editor/slash-commands/): Slash commands Press / on an empty line to open the command menu. Type to filter, ↑ / ↓ to navigate, Enter to insert. Every command Three groups, all sharing the same picker. Basic... - [File types](https://runcabinet.com/cabinet/data/file-types/): File types Cabinet treats specific file formats as first class views . Drop them in your cabinet folder and they render inline — markdown, CSV, PDF, mermaid, images, video, audio,... - [CSV data](https://runcabinet.com/cabinet/data/file-types/csv/): CSV data Files: .csv . CSV files render as an interactive table editor in Cabinet. Click a cell to edit, press Tab / Enter to navigate, sort by clicking a header. Toggle to source... - [Embedded apps](https://runcabinet.com/cabinet/data/file-types/embedded-apps/): Embedded apps A folder with an index.html at its root and no index.md is treated as an embedded app. Cabinet renders it in an iframe inside the main panel. Standard embedded app Th... - [Google Workspace pages](https://runcabinet.com/cabinet/data/file-types/google-workspace/): Google Workspace pages A markdown page with a google: key in its frontmatter becomes a live iframe of a Google Sheet, Slide deck, Doc, or Form right inside Cabinet. Open the page —... - [Images](https://runcabinet.com/cabinet/data/file-types/images/): Images Files: .png .jpg .jpeg .gif .webp .svg .avif .ico . Images render with the native browser viewer . Drop an image anywhere in your cabinet folder and it appears in the sideba... - [Linked content](https://runcabinet.com/cabinet/data/file-types/linked-content/): Linked content Cabinet can point at folders that live elsewhere on disk without copying anything. Two flavors: Linked directory — a plain symlink. Behaves like any folder in your c... - [Markdown page](https://runcabinet.com/cabinet/data/file-types/markdown/): Markdown page Files: .md , plus any folder with an index.md at the root. The most common file type in a cabinet. Renders in the WYSIWYG editor with a source toggle so you can see a... - [Mermaid diagram](https://runcabinet.com/cabinet/data/file-types/mermaid/): Mermaid diagram Files: .mermaid , .mmd . Cabinet renders Mermaid files as diagrams. Open a .mermaid file in the sidebar — it shows the rendered diagram with a source toggle to swit... - [Office documents](https://runcabinet.com/cabinet/data/file-types/office-documents/): Office documents Files: .docx , .xlsx , .xlsm , .pptx . Office files render inline, read only in Cabinet. Drop a .docx , .xlsx , or .pptx anywhere in your cabinet folder and it app... - [PDF document](https://runcabinet.com/cabinet/data/file-types/pdf/): PDF document Files: .pdf . PDFs render with the browser native viewer — pagination, zoom, search, print, and download all work without a third party library. Drop a PDF into your c... - [Source code](https://runcabinet.com/cabinet/data/file-types/source-code/): Source code Files: .js .ts .tsx .jsx .json .css .html .py .go .rs .swift .kt .java .rb .php .sh .yaml .yml .toml .sql .md .mjs (and more). Source files render with a syntax highlig... - [Video & audio](https://runcabinet.com/cabinet/data/file-types/video-and-audio/): Video & audio Video files: .mp4 .webm .mov .m4v . Audio files: .mp3 .wav .ogg .m4a .aac . Both render with native browser players . Drop them in your cabinet, they appear in the si... - [Tasks](https://runcabinet.com/cabinet/tasks/): Tasks The Tasks tab is what the team does . Real teams have rhythms — a Monday standup, a Friday update, an inbox check at 9am. Cabinet has the same three rhythms. The three rhythm... - [Concepts](https://runcabinet.com/concepts/): Concepts Six pages that explain the product model and the values behind Cabinet. If you've read Philosophy and want the next layer down — start here. The model What is Cabinet App... - [AI Runtime](https://runcabinet.com/concepts/ai-runtime/): AI Runtime How an agent's call actually reaches a model — and what's between you and the inference. The adapter layer Every AI call in Cabinet — a task, a routine, a heartbeat, a c... - [AI Team Concept](https://runcabinet.com/concepts/ai-team/): AI Team Concept Cabinet treats AI helpers as a team that works inside your knowledge base. An agent can have: A persona. A goal. Skills. Scheduled jobs. Memory files. A workspace f... - [Cabinet File Format](https://runcabinet.com/concepts/cabinet-file-format/): Cabinet File Format A cabinet is a folder with a small manifest and regular files. The .cabinet manifest names the cabinet and tells Cabinet whether the folder is a root cabinet or... - [Cabinet vs the alternatives](https://runcabinet.com/concepts/comparison/): Cabinet vs the alternatives Cabinet sits in a space that doesn't have an obvious incumbent. It's not just a notes app , not just an AI assistant, not just a file manager. It's the... - [Principles](https://runcabinet.com/concepts/principles/): Principles Cabinet is built around a few principles we think matter deeply for the future of AI + data tools. Every product decision gets weighed against these. Yours Your data sta... - [What is Cabinet App](https://runcabinet.com/concepts/what-is-cabinet-app/): What is Cabinet App Cabinet is a local first knowledge base with AI work built into the workspace. It gives you: A file tree for your knowledge base. A rich markdown editor. Search... - [Getting Started](https://runcabinet.com/getting-started/): Getting Started with Cabinet Cabinet is an AI first knowledge base. Everything lives as files on disk — no database, no cloud lock in. You write pages in markdown, organize them in... - [Apps and Repos](https://runcabinet.com/getting-started/apps-and-repos/): Apps and Repos Cabinet goes beyond markdown pages. You can embed full web applications , link external Git repositories, and create interactive tools that live right alongside your... - [Delegating Between Agents](https://runcabinet.com/getting-started/delegating-between-agents/): Delegating Between Agents A Cabinet agent isn't just a solo operator — it can propose work for teammates . When the CEO plans a launch, it can dispatch research to the analyst, dra... - [Skills](https://runcabinet.com/getting-started/skills/): Skills in Cabinet Skills are reusable bundles of instructions (and optionally scripts) that an agent can pull in for a task. Each skill is a directory containing a SKILL.md (frontm... - [Symlinks and Load Knowledge](https://runcabinet.com/getting-started/symlinks-and-load-knowledge/): Symlinks and Load Knowledge Cabinet uses direct symlinks to bring external folders into your knowledge base without copying anything. The folder stays where it is on disk — Cabinet... - [Guides](https://runcabinet.com/guides/): Guides Practical workflows for using Cabinet. Create New Cabinet Tasks and Routines Skills Showcase - [Apps & repos](https://runcabinet.com/guides/apps-and-repos/): Apps & repos Cabinet goes beyond markdown pages. You can embed full web applications , link external Git repositories, and create interactive tools that live right alongside your d... - [Features](https://runcabinet.com/guides/features/): Features Everything Cabinet does, on one page. Each feature links to the deep dive. Knowledge & editor The surface where you read, write, and search. | Feature | What it is | Read... - [Load knowledge](https://runcabinet.com/guides/load-knowledge/): Load knowledge Cabinet uses direct symlinks to bring external folders into your knowledge base without copying anything. The folder stays where it is on disk — Cabinet just creates... - [Tasks and Routines](https://runcabinet.com/guides/tasks-and-routines/): Tasks and Routines Tasks are one off pieces of work. Routines are tasks that run on a schedule. Good task examples: Launch ten separate competitor brief tasks and synthesize the re... - [Tips & best practices](https://runcabinet.com/guides/tips/): Tips & best practices The small habits that compound. Skim by section. Getting the best results from agents Anchor every agent to a folder. Agents that own a folder write predictab... - [Write & edit](https://runcabinet.com/guides/write-and-edit/): Write & edit Cabinet's editor is Notion grade WYSIWYG on top of plain markdown. Everything you type roundtrips to a file on disk. Toggle Source in the top right to see the raw mark... - [Install Cabinet](https://runcabinet.com/install/): Install Cabinet Get from zero to a running cabinet in under five minutes. The first run wizard creates your data folder, seeds an example cabinet, and asks you to plug in one model... - [Integrations](https://runcabinet.com/integrations/): Integrations What Cabinet connects to. Grouped by category, with status pills. AI providers Cabinet is bring your own AI . Connect the providers you already pay for; Cabinet routes... - [Philosophy](https://runcabinet.com/philosophy/): One place for all your work Most of your day is spread across tools that don't know each other. Notes in Notion. Files on Drive. Tasks in Linear. Threads in Slack. Research in chat... - [Reference](https://runcabinet.com/reference/): Reference Technical details for Cabinet users and builders. CLI Reference File Structure - [CLI Reference](https://runcabinet.com/reference/cli/): CLI Reference Cabinet's CLI is intentionally small. Most of the work happens inside the app , and the CLI exists to start, scaffold, diagnose, and update. If you've installed Cabin... - [File Structure](https://runcabinet.com/reference/file-structure/): File Structure Common cabinet paths: | Path | Purpose | | | | | .cabinet | Cabinet manifest | | index.md | Entry page | | .agents/ | Agent personas and memory | | .jobs/ | Schedule... - [Job schema](https://runcabinet.com/reference/job-schema/): .jobs/ .yaml schema Routines are YAML files in .jobs/ . The filename becomes the routine slug. For the conceptual story see Routines. This page is the field by field reference. Min... - [Manifest schema](https://runcabinet.com/reference/manifest-schema/): .cabinet — manifest schema Every cabinet folder has a .cabinet file at its root . It's the only file Cabinet requires . Without it, a folder is just a folder; with it, the folder b... - [Persona schema](https://runcabinet.com/reference/persona-schema/): persona.md schema A persona is a markdown file at .agents/<slug>/persona.md . The frontmatter (between the two lines) is structured. The body is the agent's system prompt . F... - [Skill schema](https://runcabinet.com/reference/skill-schema/): SKILL.md schema A skill is a folder. SKILL.md is the manifest the agent reads. For the conceptual story (and the security model) see Skills. This page is the field by field referen... - [Roadmap](https://runcabinet.com/roadmap/): Roadmap What's already shipping, what's in flight, what's planned next. Legend: 🟢 Shipped · 🔵 Improved · ⚪ Planned (not yet built) · 🔴 Removed/Breaking · 🟣 AI & Skills ✅ Alread... - [Showcase](https://runcabinet.com/showcase/): Showcase This page is a public safe demo of how Cabinet can feel when a knowledge base also has agents, tasks, routines, screenshots, and generated reports. The panels on this page... - [Agents Workspace](https://runcabinet.com/showcase/agents/): Agents Workspace This is a read only public version of Cabinet's Agents workspace. It uses static sample agents to show the real product shape: team counts, the org chart action, a... - [Tasks Board](https://runcabinet.com/showcase/tasks/): Tasks Board This is a read only public version of Cabinet's task board. It shows the same work surface shape as the app: view controls, filters, trigger chips, lanes, cards, agent... - [Cabinet Stories](https://runcabinet.com/stories/): Cabinet Stories How real people use Cabinet. These cards are illustrative examples for now — the page is wired to swap in real Discord, X, and GitHub quotes as they come in. Filter... - [Templates](https://runcabinet.com/templates/): Template cabinets You don't have to build your AI team from scratch. cabinets.sh is a public registry of plug and play cabinets — each one is a complete folder with agents, jobs, k...