Troubleshooting and FAQ

Before you start

Most problems are one of three things: your AI tool isn't signed in, it lacks a permission, or a step is waiting for you.

Ask where things stand
Ask in your AI tool
In SwiftCNS, what's the current step on [project], and is anything waiting for me?
Match the symptom below

Connection

401 or "invalid credentials". Sign in again from your client. A removed authorization needs a fresh sign-in.
No workspaces listed. You signed in with a different account, or you haven't created a workspace.

Workflow

Nothing happens after a choice. Ask your AI tool to continue, or check Now in the app. After assigning or approving, the next card is already waiting. After setting up the tracker, add rows; Complete tracker appears once there are rows.
No Learning draft after completing the tracker. Ask your tool to continue the conversation. If it says the evidence isn't available yet, wait a minute and ask again.
The Learning is published but no decision was offered. Expected today. Ask for a decision review.
Your tool can't select or approve. It lacks Make decisions. Reconnect and grant it, or act in the app.
Replies take 20 to 60 seconds. Normal; each step runs SwiftCNS's own agents.
The Learning result already reads Unclear. Some versions of the app show Unclear until you choose. It isn't a judgment; choose your own.

FAQ

Do I need SwiftCNS to use the method? No. The method works with a spreadsheet.
Which AI tools work? Claude, ChatGPT (developer mode, depending on your plan), Cursor, Claude Code, Codex, and any MCP client with remote HTTP servers and OAuth.
Can my AI tool see other teams' work? No. It sees only what you can.
Does recording a decision change anything? No. It records the choice; your team carries it out.
Can I change a Learning or a decision? No; both are fixed once published or recorded. Record a new decision that replaces the old one; both stay on record.
Is MCP included in my plan? Yes, on every plan, Free included. The app and MCP share usage.
What happens when I run out of usage? The chat says You've used this month's usage. Upgrade under Manage plan, or continue when usage resets with your billing cycle. Nothing recorded is lost. See Plans and usage.
Do you train AI models on my content? No. We use it to run and improve SwiftCNS. See Security and data.
How do I disconnect my AI tool? Settings → MCP client access, under Authorized applications.

Still stuck? Open the conversation in the app (your AI tool can give you the link) and check the Now tab.

For agents: MCP tools and gotchas

get_conversation_progress returns browserUrl for the conversation. If execution.retryable is true after a failure, call retry_response.