Key Concepts
Learn the core objects and workflows that shape how OpenSana works.
OpenSana is built around a small set of concepts that connect the UI, CLI, and backend.
Organizations
Organizations are the top-level boundary for people, projects, and administration.
Use them to:
- group related teams or clients
- manage shared membership
- centralize admin permissions
Projects
Projects are the working area where tasks and threads live.
Each project has:
- a human-readable name
- a short alias such as
WEB - members and permissions
- task data
- AI threads and connected CLI context
Tasks
Tasks are the main work item in OpenSana.
Tasks can hold:
- workflow state
- assignees and due dates
- comments
- attachments
- artifacts
Threads
Threads are persistent AI conversations attached to project work.
They can be project-level or task-related, and they execute through connected CLI runtimes.
CLI Profiles
CLI profiles map a local machine and working directory to an OpenSana project.
They are what let OpenSana send thread work to a compatible local agent runtime.
Next Steps
- Start with
Quick Start - Browse the
User Interface - Connect the
CLI