Help & FAQ
Getting Started
How do I set up a new project?
1. Log in to your Bordly account
2. Click "Create Project" on your board
3. Copy the setup command (looks like: npx bordly init setup_xxx)
4. Run it in your project's terminal
5. Start working with Claude and your board updates automatically
How does Claude update my board?
When you run the setup command, it adds instructions to your CLAUDE.md file. Claude reads these instructions and uses simple API calls to update your board as you work together. No AI processing happens on our end, just storing card titles, statuses, and file references.
What are the different token modes?
Minimal (~100 tokens/session): Updates only at session end. Best for token-conscious users.
Standard (~500 tokens/session): Recommended. Updates during work with key file references.
Verbose (~1500 tokens/session): Detailed instructions and context for complex projects.
Security
I think my API key was leaked
Go to Settings, Projects, Regenerate API Key immediately. The old key will stop working instantly. You will need to run the setup command again in your project.
Someone is creating cards I did not make
Regenerate your API key immediately, then delete the unwanted cards.
Is my data secure?
Yes. We only store card titles, statuses, and file paths. We never store your actual code, conversation history, or any sensitive data. Your API key is hashed in our database.
Can you see my code?
No, never. We only store lightweight pointers to your files, like /src/auth.ts, not the code itself.
Troubleshooting
Claude is not updating my board
1. Check that .bordly/config exists and has your API key
2. Make sure CLAUDE.md has the Bordly instructions
3. Try re-running the setup command
4. Ask Claude to run ./.bordly/bordly.sh get to test the connection
The setup command is not working
1. Make sure Node.js is installed (run node -v)
2. Check that the setup token has not expired (they last 1 hour)
3. Generate a new setup token from Settings if needed
I hit my free tier limits
Free tier allows 3 active cards per project. You can archive completed cards to free up space, or upgrade to Pro for unlimited cards and projects.
Billing
How do I upgrade?
Go to Settings, Upgrade. You will be redirected to Stripe to complete your subscription.
How do I cancel?
Settings, Manage Billing. This will open the Stripe customer portal where you can cancel your subscription.
Can I get a refund?
Yes, within 7 days of purchase. Contact us with your request.
Still need help?
Cannot find what you are looking for? We are here to help.
Contact Support