You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Codex Desktop: support nested local projects in the Projects sidebar #33304
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.
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:
one broad parent project with a clean sidebar but weaker per-project separation, or
many focused child projects with strict working directories but an unmanageable flat sidebar.
A nested project view would retain both organization and isolation.
This request is specifically about representing saved local projects according to their parent/child directory relationship, while keeping each project operationally independent.
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.
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.
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.
Activity
nathanlannan commentedon Aug 27, 2026
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:
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.
awssman commentedon Oct 4, 2026
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:
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:
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.
cyberxz2077 commentedon Oct 5, 2026
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:
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.