Quickstart
This walkthrough takes about ten minutes. By the end you will have a project with a dataset, an agent conversation that read it, and a short writeup that quotes one of its findings. It is the smallest end-to-end example of why Titan exists in one app instead of three.
You do not need any sample files. Step 1 creates a project with one of Titan’s presets.
1. Open a project
Section titled “1. Open a project”- Open Titan in any modern browser (Chrome, Edge, or Firefox).
- On the dashboard, click New project.
- Pick the Markdown preset and click Let’s start.
You should see a new workspace open with one or two starter files in the file explorer sidebar. The header storage icon shows a browser glyph, which means the project lives privately in this browser by default. See Where does your work live? if that is surprising.
2. Add a dataset
Section titled “2. Add a dataset”You can drag any .csv file from your computer into the file explorer. If you do not have one handy, save the following snippet as sample.csv and drop it in:
date,product,units_sold2026-01-04,bagel,422026-01-04,muffin,182026-01-05,bagel,552026-01-05,muffin,122026-01-06,bagel,312026-01-06,muffin,27Click the file in the explorer to open it. Titan opens CSV files in the data viewer, not a text editor. You should see six rows in a table.
3. Ask the agent a question about the data
Section titled “3. Ask the agent a question about the data”- Open the right sidebar if it is hidden, and click AI Chat.
- In the chat composer, click the attachment button and pick
sample.csv. This step is required. The agent reads the file tree and the path of your active file, but not its contents, unless you attach the file explicitly. See What the agent can see for the exact scope. - With the
sample.csvattachment chip visible above the prompt input, type a question about the data. For example:What does sample.csv contain, and which product sells better? - Send.
You should get an answer that names both products from the file and a comparison (in this example, bagels outsell muffins). If the answer is vague or invents numbers, the file was not attached. Check for the chip and resend.
4. Turn the answer into a paragraph
Section titled “4. Turn the answer into a paragraph”- In the file explorer, click + and create a new file called
notes.md. - Open it. The Markdown preset opens new
.mdfiles in Visual mode by default, which is what you want for prose. The mode toggle in the status bar lets you switch to Code if you prefer raw Markdown. - Copy a sentence from the agent’s answer into the file, or paraphrase it. Add a heading at the top.
Save (Cmd/Ctrl-S). The change is persisted to the browser-backed project.
5. Confirm your work persists
Section titled “5. Confirm your work persists”Close the browser tab, then reopen Titan from your bookmarks or history. The project should be in your dashboard, the same files should be in the explorer, and notes.md should still contain what you wrote.
If the project is missing, check that you are signed into the same account and using the same browser profile.
What you used
Section titled “What you used”| Step | Where to learn more |
|---|---|
| Create a project | Projects, Create or open your first project |
| Add a CSV | Data files |
| Ask the agent | Workspace agent, What the agent can see |
| Write in Visual mode | Editing modes |
| Where files live | Storage and privacy |
Alternative starts
Section titled “Alternative starts”You already have files on disk. Use Open from computer → Open folder instead of New project. Titan opens the folder in place and writes edits straight to disk. The walkthrough above still works on top of that project.
You want a writing-first flow without the dataset step. Skip steps 2 and 3. Create notes.md from step 4 and write directly in Visual mode. You can come back to the agent later by opening AI Chat in the right pane.
If something looks wrong
Section titled “If something looks wrong”- The CSV opens in a code editor, not a table. The file may have a different extension. Rename it to end in
.csvand reopen. - The agent’s answer is vague or invents data. The file was not attached. Open AI Chat, click the attachment button, pick the CSV, and resend. The agent reads the file tree and your active file’s path but not its contents without an explicit attachment.
- The mode toggle in the status bar is missing. The active file format does not support Visual mode. See Editing modes for the list of formats that do.
- The project is gone after reopening. Browser storage is per-browser-profile. Signing in or switching to a different browser does not migrate the project. To get the same project on another device, share it from the header.
Open folderis greyed out. That control needs File System Access, which Chromium-based browsers support but Firefox does not. Use Chrome, Edge, or Arc, or stay in browser storage.