FAQ

​

Is TurenOS a sandbox?

No. Approved tools execute with your user privileges. Use a VM, container, or disposable account for hostile code.

​

Which agent providers are supported?

Claude Code subscriptions and OpenAI Codex OAuth are supported, alongside API-key and custom-endpoint providers. Availability depends on the connected server and installed provider integrations. TurenOS permissions remain the execution boundary regardless of provider.

​

Why do files and commands still use forge?

TurenOS is a hard fork with compatibility-sensitive identifiers. The CLI, configuration paths, protocol values, and some bundle IDs retain forge names so existing data and integrations continue to work.

​

Do Desktop users need the forge runtime downloads?

No. Desktop installers contain the correct forge-cli sidecar. Standalone forge-* archives are for CLI, server, shell-installer, and npm use.

​

Where is my data stored?

See Data locations. Sessions and credentials are local by default, but provider and integration requests can leave the machine.

​

Can I use a subscription instead of an API key?

The Claude Code provider can use an existing local claude auth login. Other providers expose API-key, OAuth, device-login, or custom endpoint flows according to their capabilities.

​

What is the difference between a project and workspace?

A project is the registered repository or directory. A workspace is an isolated Git worktree used to run a session separately from the main checkout.

​

What survives closing the app?

Projects, sessions, messages, tools, settings, Extensions, automations, memory, and goals are durable. Active process-local execution stops when its owning process exits.

​

Why does an MCP card say Needs Auth?

The server is installed and enabled but has no valid OAuth token. Click Connect and complete authorization in your browser.

​

How do I verify a download?

Use the signed checksum manifest, detached artifact signature, and native platform signature described in Release verification.

​

Where can I report a bug?

Open an issue at github.com/turenlabs/turenos/issues. Report security vulnerabilities privately through GitHub Security Advisories.