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-agenthost 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
- 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.
- 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/planfirst. Start a task with files and folders - 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
- Start a task with files and folders
- Choose models and understand usage
- Understand agent permissions
- Guide and interrupt work
- Plan work, choose effort, and pursue a goal
- Inspect and save results
- Return to work and manage chat history
- Use chat commands, skills, and tools
- Change agent settings
- Configure hooks
- Desktop settings
- Work with subagents
- Schedule a follow-up (headless and ACP clients)
- Connect an agent client
- Connect another agent to Grida with MCP
The feature catalog lists each capability's availability, and the agent configuration reference covers the configuration file.