DOCUMENTATION
Set up, use and build with your agent
How to set up your Gina AI agent, work with it day to day, and build your app with it. New here? Start with Getting started: the words we use, what is yours, and what you can build.
Start here
Release notes
What changed in each update, newest first.
Set up your agent
From your invite to a running agent: create your account, name the agent, connect Claude, and, when your plan includes one, choose what your app starts from.
How your agent works
Where your agent runs, what happens when you message it, what it remembers between tasks, and what it cannot do.
Getting good results
How to brief an agent: state the goal and the constraints, point it at ground truth, and size the task so it lands.
Working with your agent
Threads and chat
Start a thread, keep it private or share it, attach files (iPhone photos and Outlook emails convert on their own), add to a task while it runs, leave a note the agent won't answer, and talk to it from Slack.
Listen and dictate
Listen to replies read aloud, with speed and skip (on an iPhone through the loudspeaker), and dictation: speak a voice message of up to 20 minutes, your words cleaned up and the original transcript kept.
Automations
Work that runs by itself: on a schedule, after a calendar meeting, or when something changes. Where results go, and when you're notified.
Inbox and approvals
Everything waiting on you or your team in one list, and how to answer the agent's approvals: checks on your test site, going live, and imports.
Connections
What your agent can use: the apps it signs in to for you (email, calendar, documents and more), how to connect or reconnect one, and how it drafts email.
Webhooks and live events
Let your own apps and your agent tell each other when something happens: a webhook (inbound endpoint) an app calls, events your agent publishes, a live stream or catch-up feed for a dashboard, and push to your app's address. Being turned on agent by agent.
To-Do's
The goals your agent is working on, each with its plan: what's in progress, what's next, and how to steer it.
Files
Everything your agent produced, in one place: preview, search, favourite, and share files as public or private links. A private link opens only for the people you name, with a code emailed to them.
Canvas
Your agent's dashboard: today's work, what's waiting on you, and tabs you design with the agent.
Your hosted app
Your hosted web app
A web app in your own cloud account, managed for you: a test site and a live site, and approvals before any change goes live.
Building with your agent
Best practices for changing your app with the agent: one change at a time, check it on the test site, keep a record of decisions, go live on your approval.
Your app's data
Bring your records in (a spreadsheet, a file or a shared link), let people sign in to your app, and what the agent can and cannot change.
Account, team and help
Access roles
Who can use your agent: share it with your team, what owners, admins, operators and viewers can do, and who may approve going live.
API keys for other tools
What can use your agent: let ChatGPT, Cursor, Claude or your own software work with one agent over MCP, as a connector, with a sign-in or a key that has only the access you choose. App clients for apps that ask for a client ID and secret.
Usage, account and plan
Usage and limits, your plan, your team, sign-in security, and preferences.
Getting help
Book a session, report an issue, or ask your agent to get a person. What to include so we can help quickly.
Security
How credentials are stored, how accounts are kept separate, how sign-in is protected, and how to report an issue.
Set-up guides
Getting your credentials
What your agent can use: its Claude connection and the keys it works with (GitHub, Slack, your own), and where each one is stored.
Slack app setup
Create a Slack app from a manifest, generate the bot and app-level tokens, and connect it to your agent.
Finding a Slack member ID
How to look up the member ID for yourself or anyone in your workspace, for the agent's allowlist.
Linking an AWS account
For agents that work in an AWS account you run yourself: a dedicated user, what it may do, a spending guardrail, and key rotation.
Agent profiles
What each profile does: engineering, analytics, research, finance, marketing, and the minimal starting point.
Agent state: codestate & memstate
Saved versions of your agent's code and memory, and how to switch between them.
Guides
Building on AWS with an agent
Infrastructure as code, separate environments, least privilege and cost guardrails, for agents that build in your own AWS account.
Autonomy, checkpoints, and stability
How much latitude to give an agent, where a human checkpoint pays for itself, and habits that keep scheduled work stable.
Working with a system you cannot fully audit
Your agent will do more in a day than you can read in a day. How to keep real oversight anyway.