Launching sessions
Start an agent in any project from the Dashboard — pick the CLI, write the first prompt, attach recent screenshots or files, and let it send itself as soon as the agent is ready.
From the Dashboard, New session starts an agent anywhere without navigating to the project first. The launch dialog is small on purpose, but it does more than open a terminal.
Since 4.0.0 the same card also opens the AI Router, for the launches where you would rather describe the task than pick a CLI and a model yourself.
The dialog
| Field | Purpose |
|---|---|
| Project | Where the session runs |
| First prompt | Injected as soon as the agent is ready. Optional |
| Send automatically | Type the prompt and press Enter, instead of only pasting it |
| Recent screenshots | Click a capture to attach it to the prompt |
| Attach files | Insert real file paths into the prompt |
| Launch without prompt | Just open the session |
Why the first prompt is worth using
Typing a prompt into a CLI that is still booting loses characters. OFM waits until the agent is genuinely ready before injecting — so “launch with a prompt” is reliable in a way that pasting by hand is not.
Leave Send automatically off when you want to reread the prompt first; turn it on for the launches you repeat every day.
Screenshots and files
Recent captures appear directly in the dialog: click one and it joins the prompt. Attached files
are inserted as real paths, converted for the target — a Windows path becomes the
distribution’s Linux path for a WSL project, because a CLI running
inside Ubuntu cannot read C:\….
Full workflow: Screenshots & images.
Missing CLI
A CLI that is not installed is shown as not installed — click for setup help, and the click opens the installation assistant rather than failing at launch.
After the launch
The new session appears as a tile on the wall, grouped under its project. From there: click the tile to take over its prompt, preview its CLI on the right, or open the project in the IDE view.
Frequently asked
- What does "Send automatically" do?
- It waits until the CLI is actually ready, then types the prompt and presses Enter. With it off, the prompt is only pasted so you can review it and send it yourself.
- Can I launch several agents on the same project?
- Yes. Each launch creates an independent session tile, so two CLIs — or two sessions of the same CLI — can work in the same folder at once.