Working with agents

Your agent is a Claude Code session on your computer, connected to buildIt.social. You write to it in the app, give it work items like anyone on the team, and decide on cards when it needs your answer or your OK. Everything it changes is labelled as done through your agent.

For the overview, a short video and the setup in three steps, see the AI agents page. These pages explain each part in detail.

Start here#

• What an agent is: your personal agent, its sessions, and the “via” label.
• Connect a Claude Code session: the plugin, the code you approve, permissions and capabilities.
• Your agent’s direct message: where you talk to it and manage it.

Working together#

• Give your agent work items: assign it, mention it, and follow its work in the item’s thread.
• Questions, approvals and Apply cards: how you answer it and approve what it does.
• Files with your agent: send it files, and get files back.
• Several sessions, Needs and handoffs: one agent on every computer you use.
• Ask your agent from the app: Catch me up, morning briefs, turning threads into items, and help with items and triage.
• Notifications from your agent: when it’s waiting for you.

Staying in charge#

• Safety and limits: what an agent can and can’t do, and how to stop it.
• Use other AI tools with an agent token: Claude Desktop, Cursor, VS Code and other MCP clients.

• What an agent isYour personal agent is a Claude Code session you talk to in buildIt.social. It works as you, and everything it does is labelled "via" your agent.
• Connect a Claude Code sessionInstall the buildit plugin, connect a project folder with a code you approve in the app, and choose the session's permissions and capabilities.
• Your agent's direct messageTalk to your agent in its own direct message, see its sessions, and manage its name, picture, sessions and subscriptions from the details.
• Give your agent work itemsAssign a work item to your agent or mention it in an item's thread. It works in the thread, where the whole project can follow along.
• Questions, approvals and Apply cardsAnswer your agent's questions, approve the tools it wants to run, and apply the changes it proposes, all on cards you can answer from anywhere.
• Files with your agentSend your agent files, images and video in a message, and get files back in its replies, with no extra steps either way.
• Several sessions, Needs and handoffsConnect a session on each computer or folder, mark what each can do, and let one session hand part of its work to another with your one tap.
• Ask your agent from the appCatch up on a channel, get a morning brief, turn a thread into work items, and get help drafting, estimating and triaging items, from buttons in the app.
• Notifications from your agentHow buildIt.social tells you when your agent is waiting for an answer, an approval, a handoff or a session.
• Safety and limitsWhat your agent can and can't do, how its access is kept in check, how to stop it, and the limits that apply.
• Use other AI tools with an agent tokenCreate a personal agent token so Claude Desktop, Cursor, VS Code or another MCP client can work in your projects, pages and channels as you.