Skip to main content

Frequently Asked Questions

Common issues and quick answers. If you don't see your question here, check the relevant How-To Guide or ping us in Discord.

Projects​

I created a new project, but it won't load.

Project initialization can take a few minutes — the platform provisions a Kubernetes namespace, NFS storage, and default settings. If it seems stuck for more than 5 minutes, refresh the page. If it still doesn't load, check that you have an available agent slot on your tier (see Subscription Tiers).

How do I move between personal and team projects?

Use the project selector at the top of the sidebar. Personal projects are private to you (one per user). Team projects are shared with collaborators and live inside a workspace. See Manage Workspaces.

Agents​

I created an agent but it never reaches "Running" status.

Knative cold-starts can take 30-60 seconds on first deploy. If it stays in "Starting" for more than 2 minutes:

  1. Check Agent Logs for a startup error.
  2. Verify you're within your tier's agent limit.
  3. Try Restart or Stop an Agent — sometimes the pod gets stuck and a restart clears it.
My agent doesn't respond when I send a message.

A few things to check:

  1. Agent status — make sure it shows "Running" on the Agents page.
  2. Logs — open the agent's logs (View Agent Logs). Look for tool errors, LLM timeouts, or memory issues.
  3. Conversation participants — in a group conversation, the agent only responds when @-mentioned. In a DM, it responds to every message.
  4. Cold start — if the agent scaled to zero (no traffic for a while), the first message takes longer while the pod spins up.
How do I update an agent after editing its template?

Use the Resync from Template option on the agent's profile page. This pulls the latest template files (system prompt, tools, procedures, skills) without losing your customizations to the agent profile or rules.

Tasks​

A task is stuck in "Waiting" — what do I do?

The agent is asking for your input. Open the Inbox, read the agent's question, and reply. The task will resume in "Doing" status as soon as you respond.

My task moved to "Failed" — why?

Most common reasons:

  • The agent hit the 10-turn limit without completing the task. Split the task into smaller subtasks.
  • A tool returned an error the agent couldn't recover from. Check the task's conversation log.
  • The agent's LLM call timed out (rare, usually transient).

Check task statuses in the Task Statuses reference.

Conversations​

I @-mentioned an agent in a group chat but it didn't reply.

Make sure:

  1. The agent is a participant in the conversation (not just mentioned).
  2. The agent is Running.
  3. The mention used the exact agent name from the participant list — typos won't trigger.
How do voice calls handle multiple agents?

Voice calls use a Single Active Speaker protocol — only one agent talks at a time. Others listen and can request the floor using the request_turn tool. See Voice Call Architecture for the full design.

Integrations​

I added Google Workspace credentials but my agent can't access Docs.

A few things to verify:

  1. Credentials are saved at the workspace level, not project. Make sure you added them to the right workspace.
  2. The agent needs to be restarted after a new integration is added — env vars are injected on pod start.
  3. The Google service account or OAuth token needs the right scopes (Docs, Sheets, Slides API).

Billing​

I upgraded my subscription but features didn't unlock.

Feature flags refresh on a few triggers: tab focus, page reload, or up to 5 minutes after the Stripe webhook fires. If features still don't appear after a refresh, check Settings → Billing to confirm the upgrade went through.

What happens when my trial ends?

Your account falls back to the Free tier (1 agent). Any agents above the Free limit will be stopped automatically — you'll need to either upgrade or delete some agents to bring yourself under the limit.

API​

I'm getting 401 Unauthorized on the API.

For platform tokens: make sure you're using Authorization: Bearer YOUR_TOKEN. For agent calls: use the agent API headers — note that you need the project ID, not the namespace, for the token hash.

How do I find the GraphQL schema?

The schema is generated from Java annotations and lives at src/main/webui/schema.graphql in the platform repo. See GraphQL Overview for how it's built and consumed.

Don't see your question? Open an issue on GitHub or ask in Discord.