Projects
On this page
Overview
Projects are the foundation of Open Poet. Each project points to a directory — either on your local machine or on a remote server via SSH — where you want Claude Code to work. From a project, you can start sessions, manage tasks, configure skills, and browse files.
Adding a Project
To add a project:
- Click Add Project from the dashboard.
- Choose the project type:
| Type | Path Format | Example |
|---|---|---|
| Local | Absolute file path | /Users/you/projects/my-app |
| Remote (SSH) | user@host:/path | deploy@server.com:/var/www/app |
- Give your project a name (or let Open Poet auto-detect it from the directory name).
- Click Save. Open Poet validates that the path exists before creating the project.
Project Settings
Each project has its own configuration, accessible from the project view:
- Skill policy — choose Inherit to receive all global skills, or Custom to pick specific skills per project. See Skills > Sync Policies.
- MCP servers — all globally enabled MCP servers are injected into sessions by default. You can override tool policies per project. See MCP Servers > Tool Policies.
- Memory document — a persistent
CLAUDE.mdfile that carries context across sessions. See Memory Documents below.
Remote Projects (SSH)
Open Poet can manage projects on remote servers via SSH:
- Add a project using the SSH path format:
user@host:/path/to/project. - Provide your SSH credentials (password or key-based authentication). Credentials are encrypted with AES-256-GCM before storage.
- Open Poet connects over SSH to start sessions and syncs skills and configuration via SFTP.
Remote sessions run Claude Code on the remote machine, so the remote server must have Claude Code installed and configured.
Memory Documents
Each project can have a memory document stored as CLAUDE.md in the project root. This file:
- Persists project context — goals, progress notes, architectural decisions, and conventions.
- Is automatically synced to the project directory so Claude Code reads it at the start of every session.
- Can be edited from the Open Poet UI or directly in the project files.
- Helps Claude Code maintain context across multiple sessions without you repeating instructions.
File Browser
Open Poet includes a built-in file browser for navigating your project's directory structure:
- Browse files and folders from the project view without leaving Open Poet.
- View file contents directly in the UI.
- Works with both local and remote (SSH) projects.