Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.pentagon.run/llms.txt

Use this file to discover all available pages before exploring further.

Chatting with Agents

The primary way to interact with agents is through the chat panel. Select an agent, type a message, and it responds — like messaging a colleague.

Sending a message

  1. Select an agent on the canvas or sidebar
  2. Focus the chat input with Cmd+L
  3. Type your message and press Enter
Your message appears in the conversation thread, and the agent begins working on it. You’ll see its status ring turn green (active) on the canvas, and an activity indicator appears just above the chat input.

Attaching images

Drop images directly into the chat — or paste from the clipboard with Cmd+V. Attachments appear as a strip above the input before you send. The chat area itself is a drop target as long as a conversation is open.

What to say

Agents respond to natural language. You can:
  • Assign tasks — “Refactor the authentication middleware to use JWT tokens”
  • Ask questions — “What does the processPayment function do?”
  • Give feedback — “The last change broke the tests. Revert it and try a different approach”
  • Set direction — “From now on, always add tests when you create new functions”
Be as specific or as open-ended as you want. Specific instructions get executed immediately. Open-ended direction shapes how the agent approaches future tasks.

Long conversations

Pentagon supports very long conversations — up to a 1M-token context window on Claude Code agents. Long histories don’t get silently truncated; the agent reads the full thread on each turn (up to the model’s limit). When a conversation gets very long, you can use /clear to start a fresh thread without losing the old one. The previous thread stays intact in the agent’s conversation list — click its DM row in the sidebar to expand all threads.

Conversation history

Every message — yours and the agent’s — is saved in the thread. Scroll up to review past exchanges. The conversation persists across sessions; close Pentagon, reopen it, full history is still there.

Searching chat

Press Cmd+F to search within a conversation. Matches are highlighted in the message thread, and you can cycle through results with the prev/next buttons or the Enter key.

Switching between agents

Drafts you’re typing are preserved per agent. Start a message to one agent, switch to another, come back — your in-progress message is still there. No more lost drafts from jumping around.

While the agent is working

The chat tab shows responses and status updates in real time. The agent’s status ring on the canvas turns green, and its sticky note updates with what it’s currently doing. If you want to bail out of a long-running response, use the Stop all button in the status bar at the bottom of the window (appears whenever agents are active).

Tips

Keep messages focused on one task at a time. Agents handle sequential, clear instructions better than long multi-part requests.
If an agent misunderstands, correct it directly — “No, I meant the users table, not accounts.” Corrections apply once and hold permanently.

Next: Agent Communication

Agents that talk to each other.