anomalyco / anomalyco/opencode
docs: explain project directories and sessions in the TUI guide
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 209k
- Forks
- 27.5k
- PR merge metrics
- PR metrics pending
Description
Feature hasn't been suggested before.
- I have verified this feature I'm about to request hasn't been suggested before.
Describe the enhancement you want to request
A new OpenCode user, especially one coming from a traditional desktop app or IDE, may not immediately understand how OpenCode organizes projects, workspaces, directories, and sessions.
I suggest adding a short section after Initialize and before Usage that explains this mental model and the common workflows around it, such as:
- what project/directory OpenCode is currently working in;
- what a workspace represents and how it relates to the project;
- how sessions relate to the current workspace/project;
- starting a separate task with
/new; - returning to an existing session with
/sessions; - starting OpenCode for another project with
opencode /path/to/project.
This would give newcomers a good conceptual model before the guide moves into individual ways of using OpenCode.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
The issue does not name a file; start with the TUI guide section around Initialize and Usage. Add a short section explaining projects, directories, workspaces, and sessions, including /new, /sessions, and opencode /path/to/project, then confirm the guide gives newcomers a clear mental model before the usage details.
Written by the indexing model from the issue text.
Assessment
- Domain
- cli, documentation
- Issue type
- Documentation
- Difficulty
- 2/5
- Estimated time
- 1-3 hours
- Activity status
- Quiet
- Clarity
- Mostly clear
- Newbie friendliness
- 68/100