Overview

Craft is an AI coworker that can take a goal from prompt to finished deliverable. It plans the work, gathers context, writes and runs code, creates files, and iterates on the result in a secure sandbox.

Ask Craft to	Example result
Research and synthesize	A customer brief grounded in company knowledge and current App data.
Create a polished deliverable	A presentation, report, spreadsheet, document, image, or export file.
Build an interactive tool	A dashboard, data explorer, calculator, or other shareable web app.
Complete work in another tool	A drafted email, updated project issue, saved file, or pull request.

A Craft session with a generated dashboard open in the Output panel

Looking to enable Craft for your Onyx deployment? See the deployment and admin guides.

Craft runs generated code in a sandbox isolated from your computer and Onyx infrastructure. Your organization controls the information Craft can access and the actions it can take. See Craft Architecture for the full trust and network model.

Start a Craft session

Each new session gets a separate workspace where Craft can create files, run code, and preview web apps. It can also use company knowledge, User Library files, available Skills, and connected Apps to complete your request.

A Craft session with the agent loop on the left and a live dashboard preview on the right

If you don’t see Craft in your Onyx sidebar, it hasn’t been enabled for your workspace. Ask an admin to turn on Craft and confirm that a supported model provider is available.

Write a strong first prompt

Pick a model, describe the result you want, and provide the context Craft should use.

The Craft home screen with the prompt box, model selector, and links to connect data sources

You can’t change models after sending the first message, so choose one before you send.

Include	What to tell Craft
End product	Whether you need a web app, report, deck, brief, data explorer, or export file.
Audience and purpose	Who will use the result and what they need from it.
Source material	Company sources, connected Apps, examples, or files Craft should reference.
Important requirements	The sections, tone, charts, filters, file names, or output format that matter.

Craft is designed to keep moving and often makes reasonable assumptions. Put important constraints in the first prompt, then refine the result as it works.

Example: build an all-hands deck

Build an all-hands slide deck for Q2. Pull the wins from Slack, reference prospects and customers from HubSpot, cite figures from our sales sync doc, and use our all-hands template.

Craft can gather the requested context, follow the presentation Skill and your company template, delegate slides to subagents, and assemble the final deck.

A Craft session building a pitch deck and delegating individual slides to parallel subagents

Follow the work

The chat panel streams Craft’s progress while it works:

Activity	What it shows
Tasks	The plan Craft is working through, checked off as it progresses.
Thinking	How Craft is approaching the next step.
Working	Tool calls, such as searching company knowledge or reading a file from an App.
Running	Commands in the sandbox, such as writing code, installing packages, or starting a development server.
Subagents	Focused agents working in parallel on parts of a larger job, such as individual slides or report sections.

Open a subagent from the header menu to read its transcript. Your messages still go to the main session. A status in the header shows when the sandbox is initializing, running, or restoring. You can guide the run at any time:

Control	What it does
Approve an action	Lets you review an App action when your organization’s policy requires approval.
Queue a follow-up	Gives Craft another instruction to pick up after its current turn.
Interrupt	Stops the current run when you press Esc. Your messages and files remain so you can redirect it.

Give Craft context

Craft can start with only a prompt, but concrete references help it find the right information and match the result you have in mind. Use + in the input bar to attach files or select a Skill or App. You can also drag files into the chat.

Source	Best for
Onyx knowledge	Company content you already have permission to access.
Public web	Current public information and websites Craft needs to navigate.
Session attachments	Files needed only for this session, such as a CSV, PDF, notes, or image.
User Library	Reusable files you want available across sessions, such as templates.
Skills	Reusable instructions, examples, and files that teach Craft a method.
Apps	Live information and approved actions in connected external services.

Session attachments stay with one session. User Library files remain available for reuse across sessions. When the Browser Skill is available, Craft can open public websites, follow links, interact with pages, and take screenshots. It uses its own browser in the sandbox, not your browser session or saved logins.

File and storage limits

These are the default limits. Your admin can adjust them for self-hosted deployments.Session attachments

Limit	Default
Maximum file size	50 MB
Maximum files per session	20
Maximum total size per session	200 MB

User Library

Limit	Default
Maximum file size	500 MB
Maximum files per upload	100
Maximum total storage	10 GB

The User Library accepts regular files and ZIP uploads. ZIP files are extracted so Craft can work with the files inside.

Don’t upload secrets, private tokens, or production credentials as files. Connect an App when Craft needs authenticated access to an external service. Raw App credentials never enter the sandbox workspace.

Review the result

Open Output from the upper-right corner of the session to inspect what Craft created.

Tab	What it shows
Preview	A live web app that updates as Craft changes its files.
Files	The full session workspace, including source code, data, and intermediate work.
Artifacts	Finished outputs intended for download or sharing, usually written to `outputs/`.

The Output panel showing the Preview, Files, and Artifacts tabs with the session workspace files

You can download individual files, download a folder or web app as a ZIP file, export Markdown as a .docx file, and preview images, PDFs, presentations, and text files. Web apps run in the sandbox and are shared through Onyx rather than exposed directly. Select Share in the Preview tab, then choose who can open the app:

Scope	Access
Private	Only you can open the shared app.
Organization	Anyone signed in to your Onyx can open it.

Sharing includes the generated web app only. It does not share the conversation or other session files.

Refine the result

Continue in the same session to request changes in plain language:

Update the layout: “Add a filter for the last 30 days and move the summary cards to the top.”
Change the writing: “Rewrite the executive summary for a non-technical audience and cut it to three sentences.”
Prepare the final file: “Add a one-paragraph summary to the report and save the final version to outputs/.”

Go further with Craft

Skills

Give Craft reusable instructions, examples, templates, and helper files.

Apps

Connect external services for live information and approved actions.

Scheduled Tasks

Run a tested Craft prompt automatically on a recurring schedule.

For admins

Enable Craft and configure models, Skills, Apps, and governance controls.

Getting Started

Core Features

Onyx Anywhere

Miscellaneous