Guides
Apps & 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 documentation.

Embedded apps

Any directory that contains an index.html file and no index.md is treated as an embedded app. Cabinet renders it in an iframe.

Standard embedded app

The app renders in the main content area with the sidebar and AI panel still visible. Good for dashboards and reference tools you want to glance at while working.

data/
  my-dashboard/
    index.html
    style.css
    app.js

Full-screen app

Add a .app marker file in the directory and Cabinet expands the iframe to full screen, hiding the sidebar.

data/
  my-launch-room/
    .app             ← full-screen marker (empty file)
    index.html

Use full-screen for immersive tools — pipeline dashboards, custom Kanban boards, embedded apps you want to feel like a Cabinet page.

Linked Git repos

A folder with a .repo.yaml at the root is treated as a Linked Git Repo. Cabinet gives agents extra context about the repo: branch, commit log, file structure, recent diffs.

# .repo.yaml
remote: github.com/you/my-repo
branch: main
description: Acme backend monorepo
language: typescript

The folder still behaves like a normal cabinet folder — pages render, files are editable, agents can write into it. The repo metadata just makes agents aware of git context.

Embedding inside a markdown page

Sometimes you want to embed a small interactive widget inline, not as a full app. Use the embed slash command:

  • /Embed — paste any URL (YouTube, Vimeo, Loom, X, etc.). Cabinet auto-detects the provider.
  • For raw iframes, paste an iframe tag in source mode.

Read on