Skip to content

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 Titan in any modern browser (Chrome, Edge, or Firefox).
  2. On the dashboard, click New project.
  3. 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.

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:

sample.csv
date,product,units_sold
2026-01-04,bagel,42
2026-01-04,muffin,18
2026-01-05,bagel,55
2026-01-05,muffin,12
2026-01-06,bagel,31
2026-01-06,muffin,27

Click 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”
  1. Open the right sidebar if it is hidden, and click AI Chat.
  2. 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.
  3. With the sample.csv attachment chip visible above the prompt input, type a question about the data. For example: What does sample.csv contain, and which product sells better?
  4. 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.

  1. In the file explorer, click + and create a new file called notes.md.
  2. Open it. The Markdown preset opens new .md files 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.
  3. 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.

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.

Steps in this walkthrough and docs that go deeper.
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

You already have files on disk. Use Open from computerOpen 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.

  • The CSV opens in a code editor, not a table. The file may have a different extension. Rename it to end in .csv and 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 folder is 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.