Your side projects make progress while you're at work.
You're on the train to work. You have an idea for your side project. You pull out your phone, open Geoff, and type:
"Add dark mode to the settings page" "Create devlopment plan for the new feature" "Implement development plan"
You put your phone away and go to your meetings. When you leave, it's done. You give your Agent next task on the way to lunch.
That's Geoff.
Geoff is a tool to Vibe Code anywhere. People who have great ideas and want AI agents to work for them, while they focus on their life. People who don't have 8 hours a day to sit in an IDE.
It lets you:
- Capture tasks from your phone while you're away from your computer
- Launch AI agents to work on those tasks
- Check progress remotely and see what got done
Your limited time should be spent on the product design and things you enjoy in life, Agents should do the work. Let AI handle the development while you focus on what's important.
Phone (any device) → Geoff → Your PC → Agents do the work
↑ ↓
└─────- Verify on the phone and your machine ──┘
- Your machine runs the orchestrator - A small Python server that can launch AI agents performing individual tasks
- Tailscale connects everything - Secure access to your machine from anywhere, no port forwarding
- Tasks live in Supabase - Free cloud database, syncs everywhere
- Web UI works on mobile - Create tasks, browse files, launch agents from your phone
- Supports Claude Code, OpenAI Codex, Google Cli, OpenCode - Wide list of providers
- A computer (Windows/Mac/Linux) that stays on
- Python 3.10+ and uv
- Node.js 18+
- Claude Code CLI (or another AI provider)
- Supabase account (free tier works)
- Tailscale (free) for remote access
# 1. Clone and run setup
git clone https://github.com/belgradGoat/Geoff
cd Geoff
./setup.sh
# 2. Set up database (one-time, detailed setup steps available in UserGuide.md)
# Go to Supabase → SQL Editor → paste supabase/schema.sql → Run
# 3. Start Geoff
./start.shThat's it. Open http://localhost:4011 in your browser.
For remote access from your phone, use your Tailscale IP (shown after setup).
Full setup guide: See docs/userguide.md for manual setup, troubleshooting, and platform-specific notes.
| Feature | Description |
|---|---|
| Create tasks | Quick-add ideas before you forget them |
| Launch agents | Tell Claude to work on a task |
| Watch progress | Stream agent output in real-time |
| Create Projects | Create folders for new projects and make your ideas happen |
| Browse and view files | Navigate your computer filesystem |
| View code | Read files to provide context |
| Create folders | Set up new project directories |
Monday morning, on the bus:
"Add a loading spinner to the submit button in ContactForm.tsx"
Monday evening, home from work:
- Open Geoff, check the task
- Agent completed, ready for review
- You review the diff, tweak as needed, move to the next task
Time spent coding: 5 minutes instead of 30
- Vibe Coders with day jobs
- Parents who code after the kids are asleep
- Anyone whose time is precious
- People who think about their side projects at work and forget by evening
This is not for:
- Teams or companies (no multi-user features)
- People who want a polished commercial product
- People who are new to Ai assisted coding
- Securely connect to your machine - Same agents, same files as when you're at your desk. Continue work from anywhere.
- Phone-first - Designed for quick interactions on mobile
- AI as collaborator - Agents work on your projects while you're busy
- Community first - I built this tool for the community, and is intended to stay free.
This is a community project. If you're a hobby developer who wants to make this better, PRs are welcome.
- Found a bug? Open an issue
- Have an idea? Start a discussion
- Built something cool? Share it
- User Guide - Detailed setup and usage
- Developer Guide - Architecture and contribution guide
This tool runs AI agents with elevated permissions that bypass normal safety confirmations:
| Provider | Flag Used | What It Does |
|---|---|---|
| Claude Code | --dangerously-skip-permissions |
Skips all permission prompts |
| OpenAI Codex | --full-auto |
Enables fully autonomous mode |
| Gemini/OpenCode | (varies) | Runs without user confirmation |
What this means:
- AI agents can read, write, and delete files without asking
- Agents can execute shell commands autonomously
- There are no confirmation prompts for destructive actions
Before using Geoff, you should:
- Understand the risks - Review what autonomous AI agents can do
- Configure allowed paths - Restrict file browser and agent access to specific directories (Settings → Allowed Paths)
- Use on non-critical projects - Don't run this on production code or systems with sensitive data
- Back up your work - Have version control (git) and backups in place
- Review agent output - Always check what the agent did before deploying changes
- Use Tailscale properly - Ensure your network is secured and only you have access
You can limit which directories Geoff can access:
- Go to Settings → Allowed Paths
- Add directories you want to allow (e.g.,
/Users/you/Projects) - The file browser and agents will only be able to access these directories and their subdirectories
When no paths are configured, all directories are accessible. Configure allowed paths to improve security.
This tool is designed for personal productivity and experimentation. Use at your own risk.
MIT - Do whatever you want with it. See LICENSE.md and Trademarks.md.
Vibe Code Anywhere
