Your first project

What this accomplishes

Save your work on disk so nothing is lost between runs. Beginners do not pick a folder — Miton creates one. You can open any folder when you are ready.

Current availability

This page documents behaviour verified in Miton development builds. Miton is still pre-release and is not publicly downloadable; invited beta users will receive a signed desktop build with automatic updates.

Before you start

• An invitation to the private beta once access opens.
• A supported Windows, macOS or Linux computer and a model provider or local model runtime.

For beginners (default)

You do not need to set up storage manually. When you type your first prompt:

1. Miton reads what you wrote and opens the matching workspace: Writer for long-form work, Canvas for front-end visual work, Code for software and Automation for workflows. Plain questions stay in Chat.
2. When any lens other than Chat opens, Miton creates a folder named after your prompt in ~/Miton Projects/. For example, “Draft a launch announcement” becomes a folder called Draft a launch announcement (slugified, capped at 48 characters, with a numeric suffix if the name is taken).
3. Miton binds file policy and project stores, then permanently binds the session to that project before the agent starts. A toast says “Saving your work in” plus the folder name.

You can rename, move, or delete that folder freely. If routing is wrong, use the workspace switcher at the top: Chat · Writer · Canvas · Code · Automation. Goals and other project intelligence live under Project in the sidebar.

The switcher is compact on narrow windows and a segmented row on wider layouts.

For intermediate and advanced users

Open a folder the way you always have:

1. Click the gear icon in the sidebar, or press ⌘O, to open the folder picker.
2. Select an empty folder or an existing code repository.
3. Click Select Folder to load the project.
4. If prompted, click Trust Workspace to allow Miton to run local commands and read files in that directory.

Recent projects appear in the TitleBar project control. Choosing a project restores its latest live session, selected worktree and last workspace. Moving between workspaces keeps the same Chat and Plan.

What success looks like

The main chat interface with the file explorer on the left and the chat console ready for prompts.

Common failures and recovery

• Missing files: If the explorer is empty, confirm you selected the correct path, or check ~/Miton Projects/ for an auto-created folder.
• Git warnings: If the folder is not a Git repository, rewind points stay disabled until Git is initialised. Run git init in your terminal to enable them.
• Auto-created folder location: Beginner-first-session projects use ~/Miton Projects/. Move the folder if you prefer another path — Miton picks up the new location when you select it from recent projects.
• Missing project folder: Miton offers Locate, Remove binding, and Cancel. It never silently attaches the session to another project.
• Wrong lens after routing: Use the workspace switcher to override.

Related next action

Connect a model so Miton can route the project work.