Skip to content

Chat

The Agent is a private conversation with the model you choose. It lives in the column on the right of everything you open; a chat can also be opened as its own tab from the … menu. New threads stay on this device until you enable encrypted relay sync.

The composer

Two buttons sit beside the message box:

  • The model button always shows the current model and, when the model supports it, the thinking level. Tap it to change the model, the thinking level, and the reply-length cap.
  • The + button holds everything else: tools, attachments, a personality prompt, and skills. When a tool is on, its icon appears on the + button.

Both selections belong to the thread, so different conversations can use different models and tools. A new chat starts from your last-used model and your default tools. See Models and tools for the full reference.

On a new, empty chat the send button shows a Speak icon. Dictation is not built yet; tapping it says so. Typing swaps it for the normal send button.

Attachments

Choose Attach files or photos under the + button. Photos require a model that declares image support. In an active thread, document uploads land in the chat's folder under Files; photos ride the message.

Large pasted text and pasted screenshots become attachments automatically instead of filling the composer.

Research with sources

Switch on search tools under the + button:

  • Nostr searches notes and long-form writing on compatible relays.
  • Web searches and reads pages through your active search provider (PayGate credits, or your own Firecrawl, Tavily, or Exa key).

The web tool's Search mode sits under it: Balanced reads a small set of promising pages; Deep Research breaks a question into parts, searches from several angles, and cross-checks sources.

The Sources panel records pages the tools actually used. Citation markers in an answer open the matching source.

Web research needs a web search provider under Settings → Custom Providers: PayGate credits work with no key, or add a Firecrawl, Tavily, or Exa key. Nostr search does not.

Work with code and previews

  • Python code blocks have a Run button and execute on your device.
  • Switch on the Python tool from the + button to let the agent use the same local runtime.
  • Switch on the Files tool to let the agent write and edit files attached to the thread. Files open beside the conversation.
  • Choose File access under the + button to give the agent folders from your workspace. Each folder is Read or Write. The agent addresses files there as Folder/name.md. Under a read-only folder it can read but not change anything.
  • Active tools and folders show as chips in the input bar. Hover a chip and click ✕ to remove it. Click a folder chip to switch Read and Write.
  • The first chip is the chat's home: the folder its files land in. By default that is a folder named after the chat under Artifacts in Files. Choose Work here on a folder (under File access, or on the folder's toolbar in Files) to make that folder the home instead. Rename the folder any time; the chat follows it. A folder shows Chats (N) for every chat that worked in it, so several chats can polish one project.
  • HTML and SVG code blocks can open in a sealed preview panel. Preview code cannot access your PlebChat data or the network.

Tool permissions

Tools run without asking by default. To approve each costly call (web searches), open the + button and set that tool to Ask each time. The choice lasts for this browser session only. File writes never ask: each turn keeps file history, so you can revert a change, and each shared folder is read-only unless you set it to Write.

Access requests

When a task needs a tool or folder this chat does not have, the agent shows a card with its reason. For a tool, Enable (⌘↵) turns it on. For files, you choose what to share: one folder with Read or Write, or Share all for every folder. For a book, Enable lets the agent read it up to your place. Skip lets the agent continue without.

Questions from the agent

Turn on Questions under + → More tools. The agent can then show a multiple-choice card when it needs a decision. Pick an option or type your own answer. Cancel lets the agent continue without one.

Incognito

Select the ghost button when a conversation must remain in memory only. Incognito hides saved Chat history without deleting it. The active conversation, sources, and draft disappear when you refresh, close, or leave Incognito.

Incognito applies only to Chat. It does not pause account sync or sync for other enabled content.

Manage threads

Open Chats from the sidebar, or the ▾ switcher at the top of the Agent column, to find, pin, rename, or delete a thread. Open the thread menu to select Sync with relays, Stop syncing, or Move to workspace. Double-click a thread name to rename it.

Each chat has its own sync policy.