# IrysQuest

- **Event:** [Meta Global AI Developer Hackathon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon)
- **When:** Oct 26, 12:00 PM – Nov 4, 9:00 PM (EST)
- **Where:** Online
- **Team:** [Manoj Prabakar](https://cerebralvalley.ai/u/safphire)
- **GitHub:** https://github.com/safphire/IrysQuest
- **Demo video:** https://www.youtube.com/watch?v=Sg_Gt-SzO2E
- **Gallery:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery
- **Page:** https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/985

IrysQuest is an agent that digs up the goals you've buried and brings you one small step. It proposes; you decide.

For judges, no accounts or keys needed: `pip install -e .` then `irysquest demo` runs the real agent on a sample quest log, with the coach's answers replayed from real Muse Spark runs (labelled on screen). `irysquest demo --serve` opens the capture page at localhost:8787. Details in the README's first section.

The problem: people with more intentions than attention don't only forget goals, they bury them. The goal is written down, known, and still not started, because each new want lands on the last. That's procrastination, which is short-term mood repair, not laziness. Every productivity tool waits for you to come back and ask for help, but a stuck person doesn't come back.

What it does:
- Every morning it reads your tracked quests, finds the ones that have gone quiet, and hands each to a coach: Muse Spark with tools. The coach looks first (the quest, its history, what you accepted and refused), then makes one move: a 2–10 minute step with a when/where cue, a subquest, park it, ask what it's for, or leave it alone.
- Momentum: finish a step from a notification with nothing next, and the coach brings the next step on the same thread.
- Sundays, a weekly reckoning over the whole board: park one to make room for another, focus, or "fine". An agent that sometimes tells you to do less.
- Capture in seconds: say it (Muse Voice Transcribe), snap a notebook page (Muse Spark vision) or type it. It splits the ramble into quests, asks one "what does done look like?" question each, and skips what's already on your list.
- It can't change your data. The server only exposes propose tools to AI; every move lands in the app's Proposals screen to accept, edit or reject. Refused steps are never proposed again, and guardrails live in code, not the prompt.

What existed before: NextQuest, my local-first Android quest log with a self-hosted sync + MCP server, existed before the hackathon and was not modified. Everything in the IrysQuest repo (the agent, coach, memory, guardrails, reckoning, momentum, capture page, demo mode) was built during the event. Every claim in the README is backed by a logged run in docs/VERIFICATION.md.

## More from Meta Global AI Developer Hackathon

- [Tobias Glawe](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/982)
- [saqlain](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/983)
- [Blocky Dragon](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/984)
- [Pip - Marco Patzelt](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/986)
- [TapLinko](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/987)
- [Sahaj](https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/988)

---

Markdown version of https://cerebralvalley.ai/e/meta-ai-developer-hackathon/hackathon/gallery/985. Site index for agents: https://cerebralvalley.ai/llms.txt · full text: https://cerebralvalley.ai/llms-full.txt
