Getting Started Tutorial
Your first agent session in 5 minutes. No credit card required.
1 Sign Up
Create a free account at myfilepath.com/signup.
Just email and password. We send a welcome email with your verification code.
2 Add Your API Key
filepath is BYOK (Bring Your Own Key). We don't charge for AI usage—you pay the providers directly.
- Get an OpenRouter key at openrouter.ai/keys
- Go to Settings / Account
- Paste your key (encrypted and stored securely)
3 Create a Session
A session is your workspace. Think of it like a project folder.
- From the dashboard, click "New Session"
- Give it a name (e.g., "API Research")
- Optional: Add a git repo URL to clone
4 Spawn Your First Agent
Agents do the work. Start with Pi for research or Shelley for coding.
- In your session, click "Spawn Agent"
- Pick an agent type (Pi, Shelley, Claude Code, etc.)
- Choose a model ( Claude Sonnet 4 recommended)
- Click "Spawn"
The agent appears in the tree on the left. Click it to chat.
5 Start Chatting
Click on your agent in the tree to open the chat panel.
- Type a message and hit Enter
- Watch the agent think, use tools, and write files
- See real-time updates via WebSocket
- Agent state persists—even if you close the tab
What's Next?
- • Build a custom agent — Bring your own Docker container
- • Learn the architecture — Understand how it all works
- • API Access — Use filepath programmatically
- • Spawn child agents — Agents can spawn agents. Build workflows.
Troubleshooting
"No API key set"
Add your OpenRouter key in Settings / Account. Or provide a per-session key when spawning.
Agent shows "disconnected"
Refresh the page. WebSocket auto-reconnects. If still broken, check your API key is valid.
Not getting responses
Check your OpenRouter key has credits. Check the agent status in the tree sidebar.