Projects & Editor

Creating a project

1. From the workspace dashboard, click New Agent
2. Enter a project name (lowercase letters, numbers, underscores)
3. Click Create

Each project contains:

• main.qosm — the entry file (always present)
• Additional modules — .qosm files you create (e.g., helpers.qosm)
• Active capabilities — configured in the Capabilities panel
• Logs — execution history

The editor

The workspace has two views:

Home view — shows your functions as a call graph or list. Click a function to see its type and effects. Double-click to jump to its code. Run individual functions with specific arguments.

Editor view — the code editor with live typechecking. Syntax highlighting, auto-save (1 second), and the inference panel showing types and effects for every binding in real-time.

Switch between views with the toggle in the header.

Managing files

• Click + in the file tabs to add a new module
• Click x on a tab to delete a module (main.qosm cannot be deleted)
• Each file becomes a module accessible via qualified names: helpers.qosm → Helpers.my_function

Publishing

1. Click Publish in the editor toolbar
2. Your agent is published at @username/agentname
3. Copy the endpoint URL from the publish menu

Published agents are callable via the Python SDK, TypeScript SDK, or any MCP client.

Shortcuts

| Shortcut | Action | |----------|--------| | Cmd+Enter | Run code | | Cmd+S | Save (also auto-saves) |