メインコンテンツへスキップ

Grida Agent

Ask the agent about a project, plan a change, or have it carry out a task.

Where you can use it​

  • Grida Desktop on macOS and Linux. Chat in a workspace folder or in a deck's own window. On macOS you can also chat about a standalone SVG. A new chat with no saved or explicit model choice prefers a ready ChatGPT subscription, currently defaulting to GPT-6.1 Sol. You can also choose a Grida account model, your own OpenRouter or Vercel AI Gateway key, or an approved endpoint. Choose models and understand usage
  • Grida Desktop on Windows opens files and media, but agent chat is not available.
  • From a script or another app. Build the grida-agent host from source to run a task headlessly or to connect a local Agent Client Protocol (ACP) client. Connect an agent client

Start a workspace chat​

  1. Open a folder in Grida Desktop and open its chat pane. The model button at the bottom right of the composer shows the model the chat will use.
  2. Describe what you want and mention the files that matter with @, for example “Summarize @README.md and list the open TODOs.” To investigate without changing anything, type /plan first. Start a task with files and folders
  3. Send. The agent reads and edits files in the project and runs commands there in a sandbox; other folders and the internet are off. Understand agent permissions

For example, with the Plan badge on, ask “Compare the two drafts and propose the smaller change.” Review the proposal, then remove the badge and send a message describing the change you want. Plan work, choose effort, and pursue a goal

Guide the work while it runs​

A message you send while the agent works joins the queue above the composer and runs next. When shown, choose Steer on it to change the current turn's direction instead. The composer's main button pauses the agent; choose ▶ to resume the same turn, or send a new message to end the paused turn and run yours next. Answer the agent's questions in their cards. Guide and interrupt work

Continue later​

Reopen a chat from the chat list at the top left of the pane to see its messages. A finished turn collapses to a Worked for … line above its answer; select it to see what the agent did. Images the latest turn produced appear below its answer. Inspect and save results

Type /fork to branch the chat and try another approach, or /compact to summarize a long conversation. Return to work and manage chat history

Give larger work room​

Choose Ultra effort in the model picker when the agent should be able to ask an independent reviewer to check its work. To keep a larger task going across turns, type /goal or choose + → Goal, describe the objective and send. Plan work, choose effort, and pursue a goal

All guides​

The feature catalog lists each capability's availability, and the agent configuration reference covers the configuration file.