Skip to main content

First conversation

Where it starts​

A new chat opens in ~/.opencli/workspace unless it belongs to a department, in which case it opens in that department's directory.

That matters more than it looks. The agent's sandbox can write anywhere inside its working directory, so the directory a conversation is open in is the whole of what it may change. It used to default to your home directory; it does not any more, and the reason is Sandbox and approvals.

Change it with the folder button above the composer.

Asking for something​

Ordinary sentences. It has your files, a shell, and whatever connectors you have added:

Read invoices.csv and list every row that breaks the rules in rules.md
What changed in this repository over the last week?
Compare their-draft.md against our-terms.md and list every clause that differs

What happens before anything is changed​

By default the agent shows you a command that is not known to be safe before running it, and shows a file write before making it. Approve or deny each one.

Three settings, in Customize:

Ask before anything unfamiliarevery command that is not known-safe is shown first
Ask only after something failscommands run unattended; you are asked when one needs more access
Never asknothing is shown before it runs

The last one is for a directory you would let a script loose in. It is explained properly in Sandbox and approvals.

Seeing what it did​

Artifacts lists the files the agent edited in this conversation, with their diffs. One honest limit: only edits made with the agent's file-editing tool are listed. Files written by a shell command it ran — a heredoc, a script, git checkout — are not tracked and will not appear.

When it stops making sense​

A conversation that has grown long is summarised so it keeps fitting. You will see Summarising the conversation…, and afterwards the thread continues with a summary in place of the older turns.

If summarising cannot help — because the length is coming from tool schemas rather than from the conversation — it says so once rather than doing it again every turn.

Next​

One conversation is one conversation. To have work happen without you being there, set up a department.