Skip to content

Codex Desktop: support nested local projects in the Projects sidebar #33304

Open

Description

@Lyhtande

What variant of Codex are you using?

App / Codex Desktop

What feature would you like to see?

When one saved local project directory is physically contained inside another saved local project directory, Codex Desktop should support displaying it as a nested child project instead of forcing every project to appear at the same top level.

An anonymized example:

C:\Workspaces\Local
C:\Workspaces\Local\reader-app

Preferred sidebar structure:

Projects
└─ Local
   └─ reader-app

Today both entries appear as top-level peers. As more subprojects are added, the Projects sidebar becomes increasingly difficult to scan.

Requested behavior

  • Detect directory containment automatically, or allow users to assign a parent project manually.
  • Show child projects below their parent with collapse/expand controls.
  • Preserve each child project's exact working directory, permissions, local environment, and project-specific configuration.
  • Allow users to switch between hierarchical and flat views if desired.
  • Keep project removal a sidebar-only action; it must not delete the underlying local directory.
  • Support more than one nesting level where the filesystem structure warrants it.

Why this matters

Umbrella workspaces, monorepos, client workspaces, and collections of small local projects commonly contain many independent subdirectories. Separate local projects are useful for focused working directories and permissions, but representing every subdirectory as a top-level sidebar entry creates unnecessary clutter.

Users currently have to choose between:

  1. one broad parent project with a clean sidebar but weaker per-project separation, or
  2. many focused child projects with strict working directories but an unmanageable flat sidebar.

A nested project view would retain both organization and isolation.

Related issues

This request is specifically about representing saved local projects according to their parent/child directory relationship, while keeping each project operationally independent.

Activity

  1. nathanlannan commented on Aug 27, 2026

    @nathanlannan

    This describes the hierarchy I need, with one additional use case: the parent may be an organizational group rather than a directory that physically contains every child project.

    For example:

    Game Boy
    ├── Platformer
    │ ├── Fix collision handling
    │ └── Add save system
    ├── Puzzle Game
    │ ├── Design level format
    │ └── Optimize renderer
    └── RPG
    ├── Add inventory
    └── Implement encounters

    “Game Boy” is the larger area of work, the individual games are independent Codex projects, and their chats remain inside their respective projects.

    Automatic grouping based on directory containment would be helpful, but manual grouping is also important because related repositories may live in separate locations. Ideally:

    • Groups can contain projects or additional groups.
    • Existing projects can be moved into and out of groups.
    • Search and Activity results show the project’s breadcrumb.
    • Groups can be renamed, reordered, collapsed, and expanded.
    • At least one level above projects is supported; deeper nesting would be preferable.

    The hierarchy should be organizational only by default. A parent group should not implicitly combine project instructions, attached folders, permissions, memories, source access, or agent context. Each child project should retain its existing isolation.

  2. awssman commented on Oct 4, 2026

    @awssman

    I support this request and would like the hierarchy to work for SSH remote projects as well as local projects.

    My workflow uses Codex Desktop on Windows connected to a Linux host through SSH. I need to organize several companies, shared operational areas and products in one navigable tree, with multiple levels of collapsible containers:

    Organization
    └── Operations
        ├── Shared Infrastructure
        │   ├── Servers & Services
        │   └── Accounts & Access
        ├── Company Operations
        │   ├── Company A
        │   │   └── Security Tools
        │   └── Company B
        │       ├── Product A
        │       └── Product B
        ├── Runbooks
        └── Change Records
    

    These should be real sidebar containers or child projects, not just indentation in a Markdown file. The filesystem can already contain this directory structure; the request is to represent and manage the organization inside Codex.

    Requested capabilities:

    • Create folders/containers and child projects at multiple levels, with expand/collapse and breadcrumbs.
    • Support both manually defined logical groups and optional import of a local or SSH folder tree.
    • Move existing projects and chats between containers without duplicating or losing conversations.
    • Keep sidebar grouping separate from execution context: each project/chat must retain its exact host and working directory. Grouping must not broaden permissions or silently change which AGENTS.md applies.
    • Provide an explicit, supported way to attach an existing chat to the intended project and verify that association.
    • Expose supported tools/API operations for agents to create, rename and organize native desktop projects and attach existing chats. Creation should be idempotent and readable back from the desktop project list.
    • Removing a sidebar container should preserve underlying folders, repositories and conversation history unless deletion is separately requested.

    In my current session, project and chat listing and section placement tools are available, but native project creation and reassignment to a different native project are not exposed. Adding filesystem folders or an App Server project record is not sufficient evidence that a native desktop project was created. A supported desktop integration would avoid repeated manual setup and keep remote working context accurate.

    The broader need overlaps with #30986 and #25498. I am adding it here because hierarchical project organization is the central requirement. Exact desktop build was not captured.

  3. cyberxz2077 commented on Oct 5, 2026

    @cyberxz2077

    Custom sidebar sections have helped my workflow, but they solve categorization rather than project hierarchy.

    I currently use sections such as Projects, Study, Life, Engineering, and Work to organize tasks and projects by area. I pin urgent or currently important items, then unpin them when that priority passes so they return to their normal location.

    What remains difficult is representing a project and its related projects or subprojects. My current workaround is to organize their local repository folders deliberately, so the filesystem carries relationships that the sidebar cannot adequately represent.

    I would like these dimensions to remain distinct:

    • Priority: temporary pinning.
    • Area of work: sidebar sections.
    • Project relationships: a navigable parent/child hierarchy.
    • Storage and execution location: the actual repository path and host.

    The distinction raised above between organizational groups and physical directories matches this need. Directory containment could help suggest a hierarchy, but related projects may live in different locations, and changing their organizational relationship should not require moving repositories.

    The sidebar should provide a clear overview of the work, with project details and resources available when expanded. Each project's working directory, permissions, and instructions should remain unchanged by grouping.

    I have described the broader tag-based organization of conversations and resources separately in #51128, which links back to this request.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    appIssues related to the Codex desktop appenhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions