Start from a workspace
Axiomate needs to know which project you want to work on. The folder you start it from becomes the main workspace for the session.
Think of the workspace as the project folder Axiomate should read, search, and edit first.
Easiest path on Windows
On Windows, you do not need to learn terminal navigation first:
- Open your project folder in File Explorer.
- Right-click an empty area in the folder.
- Choose Open in Terminal.
- Type:
axiomate
Axiomate will use that folder as the workspace.
If you already use a terminal
cd means “change directory”, or move into a folder. If you already use a terminal, go to your project folder first, then start Axiomate:
cd /path/to/your-project
axiomate
For example, if you want Axiomate to work on my-app, open or enter the my-app folder before running axiomate.
If you start from the wrong folder, Axiomate may not find the files you mention, or it may search a different project.
What the workspace controls
The workspace affects:
- Which files Axiomate searches and reads first.
- Where commands run by default.
- Which paths are included in the permission scope.
In short, it is the project scope for this session.
Add another folder
Sometimes a task needs another local folder, such as a backend project, a shared package, or external docs. Use /add-dir to add it:
/add-dir /path/to/another-directory
Or run it without a path to open the directory picker:
/add-dir
You can add the directory for this session only, or remember it in local project settings for future sessions.
When to use add-dir
Use it when a task needs files outside the current project, such as a sibling package, shared library, or external docs directory.
You do not need it for subfolders already inside the folder where you started Axiomate.