Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.happycapy.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Overview

A Project is a named project workspace. Each Project gets its own directory inside your sandbox at ~/a0/workspace/<project-id>/. All sessions you open within that Project work in this shared directory — they read and write the same files. This makes Projects useful for work that spans multiple conversations. Start a task in one session, pick it up in another, and the files are already there.

​
Sessions

Your workspace, organized

One project. Shared files. Multiple sessions.

Multiple sessions in a Project
Inside each Project, you can run multiple sessions at the same time. Each session is its own conversation thread, but they all share the same project directory. Practical uses:
  • One session generates images while another writes the accompanying copy
  • One session handles frontend code, another handles the backend
  • One session researches a topic, another drafts the report
All output lands in the same ~/a0/workspace/<project-id>/ folder. To open a new session: click the + button next to the session name at the top of the Project. To switch between sessions: click the session name dropdown at the top.

​
Folders

Folders group Projects in the sidebar. Click the + icon next to “Projects” (Create Folder) to make one. Example structure: 
📁 dev
  ├── my-app frontend
  ├── my-app backend
  └── deploy scripts

📁 content
  ├── blog posts
  └── social media
Folders are organizational only — they don’t affect the filesystem.

​
Favorites

Click the ☆ icon in a session’s header to pin it to the Favorites section at the top of the sidebar. Useful for sessions you return to often. Click again to remove.

​
Creating a Project

Click New Project in the sidebar. Give it a name that reflects the project. Happycapy creates a fresh workspace directory for it.
One Project per codebase or initiative is a clean setup. Use multiple sessions within it when you want to run tasks in parallel — they all share the same output folder, so results stay together.