# Ledge

> Ledge is the notebook 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), with an iOS app 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, and which machine they run on.
- [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 or iPad 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.

## 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 on your server, into an S3-compatible bucket every hour.
- [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.