Core concepts

Open Cottage works by combining a browser, an authorized local folder, a model, and the capabilities you choose for the task. The folder is the workspace boundary; the browser holds the interface and origin-level settings; the Agent turns the request into inspectable file work.

• Workspaces — which files the Agent can access
• Your data stays local — where .cottage/ state and keys live
• Site and workspace settings — what is shared and what follows a folder
• Models, presets, and API keys — how model configuration is stored
• Capability packs — why some tools are enabled per task
• File previews — how to inspect results
• Chats, plans, and sessions — the two collaboration modes
• Staged review and approval — how changes remain controllable
• Skills — reusable task instructions
• Cottage Service — optional web and search companion service
• @ references and attachments — how to attach workspace context
• Model and capability panel — controls above the composer