dl4rce/flaiwheel

What's New

AI agents can now onboard new projects and bind to them without leaving the IDE.

New Tools (21 total)

| Tool | Purpose |
|------|---------|
| setup_project(name, git_repo_url, ...) | Register + index a new project directly from the agent |
| set_project(name) | Bind all subsequent calls to a specific project (sticky session) |
| get_active_project() | Show which project is currently bound |

How It Works

1. Agent opens a new project → Flaiwheel is already connected (global MCP config)
2. Agent calls set_project("my-app") → all subsequent calls target "my-app"
3. If the project isn't registered: setup_project("my-app", git_repo_url="...") creates it and auto-binds

Resolution Order

Every tool still has the project parameter as a hard safeguard:

1. Explicit project= — always wins
2. Sticky _active_project — set by set_project / setup_project
3. Default first project — backward compat

Agent Instructions Updated

• Cursor rules (.cursor/rules/flaiwheel.mdc) and AGENTS.md now instruct agents to call set_project() at the start of every conversation
• All FLAIWHEEL_TOOLS.md templates updated with the full 21-tool table

Upgrade

Run the install script from your project directory to update.