Open your first project
Sirius is a folder-based IDE — there’s no “workspace” concept. Open any directory and the agent will index it.
Open a folder
File → Open Folder… or drop a folder onto the welcome screen.
The agent scans:
- File tree (respecting
.gitignore). - LSP-provided symbols (for the languages where the LSP server is up).
- A token-budgeted summary of large files.
Indexing is incremental — it doesn’t block the editor.
Talk to the agent
Open the agent panel (default shortcut Ctrl+L / Cmd+L). Type a
natural-language request:
Find duplicated bcrypt verification logic and extract it into
auth/passwords.py::verify_password.
The agent will:
- Read the files it needs.
- Show a diff in the editor.
- Ask you to approve before writing anything.
You can scope the conversation to specific files by typing @, then
selecting them from the picker.
Tools available
| Level | What the agent can do | Confirmation |
|---|---|---|
| L1 Suggest | Reads files, replies in chat | None |
| L2 Auto-edit | Writes file patches | Per-file diff |
| L3 Agent | Runs terminal commands | Per-command |
Switch level from the agent panel header. The level resets to L1 every time you open Sirius — by design.