Skip to content
MISSIONBuilding to $50K/year · partnership threshold — every $20 subscription reserves 10 meals in the fund. Report published monthly.SEE THE PROGRESS →
DOC · UPDATED 2026-08-06

Projects.

A Project groups related chats, attaches persistent files, and holds project-specific instructions. This is the reference for what a project is and every setting it exposes.

A LADLE Project is a folder around a working context: a set of files that persist across chats, custom instructions that override defaults within the project's scope, and a running list of the chats you've had inside it. Use projects for anything you'll come back to more than once — a codebase, a book you're writing, a case you're researching, a recurring workflow.

What a Project contains

Four things sit at the project level and inherit into every chat you start within it.

Files (persistent)Up to 50 files, all attached to every chat inside the project
Custom instructionsFree-form text that acts as system prompt for chats in this project
ChatsEvery chat you start inside the project appears here
Name + descriptionHuman-readable metadata

Creating, renaming, deleting

Create: click New Project in the sidebar footer, or ⌘P. Rename: right-click the project in the sidebar → Rename, or ⌘⇧R with the project selected. Delete: right-click → Delete Project. Deleting cascades to every chat in the project; the confirmation modal shows the count. Chats can be moved between projects (drag or right-click → Move to…).

Custom instructions

Every project has a custom-instructions field (Project → Settings → Instructions). What you write here is prepended as system context to every chat in the project. Use it for: writing voice, response formatting preferences, project-specific vocabulary, roles the assistant should assume. Global custom instructions (Settings → Personalization) still apply; project instructions layer on top.

Files inside a Project

Files attached to the project appear in Project → Files. Every file counts against the 50-file cap. Files inherited from the project into a chat still count against the per-chat 30-file cap.

Persistent project filesUp to 50
Per-chat additional attachments30 (inherits from project + adds to)
File replacementUpload a file with the same name → replaces the previous version
Version historyNot currently retained

Sharing (not currently available)

Projects today are per-user. You cannot share a project with a teammate as of 2026-08-06. Team sharing is on the roadmap; when it ships, per-project permissions (view / edit / admin) will be scoped to workspace members. For now, if you want to collaborate: export the project's instructions + a file list and share those; each collaborator sets up their own project.

Searching inside a Project

⌘K with a project active scopes global search to the current project first, then falls back to your other chats. Search matches: chat titles, chat body, and attached file contents (for text-based files).

Docs stay current. Report drift.

If a limit in the product doesn't match the number on this page, that's a bug — help@ladle.chat.

See all docsWatch it work
$20/MO · CANCEL ANYTIME · $0.80/MEAL · RECEIPTS MONTHLY
Read the ledger →
0meals fundedROLLING TOTAL · UPDATED HOURLY
SEE THE RECEIPTS →