Skip to content

docs: explain project directories and sessions in the TUI guide #40938

Description

@tnspacetime

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.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions