Skip to main content

​
1. Download TurenOS

Open the latest GitHub release and choose the Desktop artifact for your platform:
  • macOS: turenos-desktop-mac-arm64.dmg or turenos-desktop-mac-x64.dmg
  • Windows: turenos-desktop-win-arm64.exe or turenos-desktop-win-x64.exe
  • Linux: an AppImage, DEB, or RPM matching your architecture
The forge-* archives are standalone CLI runtimes. Desktop installers already contain the correct runtime sidecar.

​
2. Complete first launch

A fresh Desktop profile opens a three-step walkthrough:
  1. Review the local-first execution model.
  2. Open Settings → Providers and connect a model provider.
  3. Choose a project directory and create your first draft session.
You can skip the tour and return to Provider Settings or New session later.
Illustrated three-step TurenOS onboarding flow: Welcome, Connect provider, and Start a session.

First launch walks from local execution through provider connection to the first project session.

​
3. Connect a provider

If you skipped that onboarding step, open Settings → Providers, select a provider, and complete its API-key, OAuth, device-login, or local-subscription flow. TurenOS stores credentials in the OS-backed Secret Vault.
The Claude Code provider can use an existing claude auth login subscription. OpenAI supports API keys and OAuth-based Codex access. You can also configure OpenAI-compatible local endpoints.

​
4. Open a project

If onboarding did not already open one, choose Open project and select a local repository or directory. For Git repositories, TurenOS can run the session in the main checkout, an existing workspace, or a newly created worktree.

​
5. Start a session

Select an agent and model, enter a prompt, and submit it. The draft becomes a durable session tab. Tool calls that need authority appear as permission requests before execution. Try:

​
6. Inspect the result

Use the timeline, file tree, review panel, diff viewer, terminal, and Git controls to inspect work. Follow-up prompts steer the active session by default; queued input waits for the next safe provider-turn boundary.

Provider setup

Connect models and local subscriptions.

Your first session

Learn the complete session workflow.