llms.txt
Compare with other sites' llms.txt files →# Ledge
> Ledge: runnable Markdown notes for developers and DevOps. It runs code and commands straight from your Markdown: write a note, run a code block in place, and its output streams in beneath it. Free and open source, on macOS (Apple Silicon), Linux, and Windows 11 (through WSL), with an iOS app, an Android beta, and a self-hosted server.
Each link below is the Markdown version of a page in the Ledge manual. Every page in one file: https://ledge.sh/llms-full.txt
## Manual
- [Getting Started](https://ledge.sh/docs.md): Ledge is the notebook for developers and DevOps.
- [Running Code](https://ledge.sh/docs/running-code.md): Any fenced code block whose language is runnable gets a Run button, and the shell behind it belongs to the note it sits in.
- [Notes and Workspaces](https://ledge.sh/docs/notes-and-workspaces.md): This page covers where your notes live and how to arrange them: the file a note is, the folder a workspace is, the folders you file notes into, how a workspace reaches other people, and the tabs and panes you read them in.
- [Panes and Tabs](https://ledge.sh/docs/panes-and-tabs.md): A workspace's editing area is a tree of panes, and each pane holds its own tabs.
- [Finding Things](https://ledge.sh/docs/finding-things.md): Four ways back to what you wrote: quick open, full-text search, links, and tags.
- [Frontmatter and Environments](https://ledge.sh/docs/frontmatter-and-environments.md): A note can declare how its shells spawn: which directory they start in, which environment variables they carry, which machine they run on, and which user they run as.
- [Profiles and Secrets](https://ledge.sh/docs/profiles-and-secrets.md): A profile is a named file of environment variables that lives outside your notes folder and is injected into the shells of any note that names it.
- [Run Code on Remote Hosts](https://ledge.sh/docs/run-code-on-remote-hosts.md): A host: line in a note's frontmatter sends every run, inline and in the terminal drawer, over ssh to the machine it names.
- [Keep Notes on a Remote Server](https://ledge.sh/docs/keep-notes-on-a-remote-server.md): Ledge can keep your notes on a server and run the app as the window onto it.
- [Ledge on Your Phone](https://ledge.sh/docs/ledge-on-your-phone.md): Ledge runs on an iPhone, an iPad or an Android phone as a window onto a server.
- [Daily Notes and Templates](https://ledge.sh/docs/daily-notes-and-templates.md): A template is an ordinary note marked template: true in its frontmatter, ready to be stamped into new notes.
- [Images](https://ledge.sh/docs/images.md): A Markdown image reference alone on its own line renders as the picture.
- [Note Locking](https://ledge.sh/docs/note-locking.md): Locking encrypts a note's body on disk behind a passphrase.
- [Agents and Ledge](https://ledge.sh/docs/agents-and-ledge.md): Ledge is built to be worked by AI agents as well as by you.
- [The ledge CLI](https://ledge.sh/docs/the-ledge-cli.md): The ledge command lists, reads, searches, creates, and appends to notes from any terminal, and runs their code blocks.
- [Keyboard Shortcuts](https://ledge.sh/docs/keyboard-shortcuts.md): Every command's keyboard shortcut can be changed, removed, or added with the keys setting.
## Tutorials
- [Tutorial: Run a Project from a Note](https://ledge.sh/docs/tutorial-run-a-project.md): Write one note that builds, tests, and runs a project, and keep it with the rest of your notes.
- [Tutorial: A Daily Workflow](https://ledge.sh/docs/tutorial-a-daily-workflow.md): Set up a daily rhythm: one keystroke opens today, today links to yesterday, and nothing you jot down goes missing.
- [Tutorial: Pair with an Agent](https://ledge.sh/docs/tutorial-pair-with-an-agent.md): Get an AI agent working inside your notes, three ways: a conversation in a note's terminal, one-shot prompt fences, and capture from anywhere.
- [Tutorial: Keep Notes Synced](https://ledge.sh/docs/tutorial-keep-notes-synced.md): Ledge notes are plain files in ordinary folders, so syncing them is just syncing a folder: iCloud Drive, Dropbox, git, Syncthing, or whatever you already use.
- [Tutorial: Set Up a Ledge Server](https://ledge.sh/docs/tutorial-set-up-a-ledge-server.md): Turn a fresh Linux VPS into a Ledge server: an account for Ledge, the server package, a key that can do nothing but Ledge, and an sshd that ignores everyone else.
- [Tutorial: Back Up Your Notes to S3](https://ledge.sh/docs/tutorial-back-up-your-notes-to-s3.md): Put an encrypted copy of your notes, and everything Ledge keeps beside them, into an S3-compatible bucket, every hour, from the machine that holds them.
- [Tutorial: Share Notes with a Git Clone](https://ledge.sh/docs/tutorial-share-notes-with-a-git-clone.md): Put a workspace in a git repository and keep a clone each, so you and the people you work with read and write the same notes.