notion hackathon may 2026

README excerpt

# Forge — Notion Custom Agent Studio

> **Describe an agent in plain English. Get a real, deployed Notion Custom Agent in 90 seconds — without ever leaving Notion.**

Forge is a Notion-native page that turns one sentence into a working, sandbox-validated, OAuth-wired Custom Agent in the user's own workspace. A manager-of-agents pipeline (Schema Smith → Tool Coder → Inspector → Shipper) generates TypeScript, runs `tsc` and `ntn workers exec` against synthetic input inside a Vercel Sandbox, and only then promotes the deploy. No editor. No terminal. No git.

---

## Why this is the best use of Notion in the hackathon

We treat Notion as the **entire surface area** — input, output, runtime, control plane, and observability all live in the user's workspace. Every interaction a user has with Forge happens on a Notion page they already know how to use; every artifact Forge produces is a first-class Notion object.

| Notion surface                  | How Forge uses it                                                                                                              |
| ------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| **Custom Agents (Workers)**     | Generated agent is deployed via `ntn workers exec` and lives in the user's workspace as a real Notion Custom Agent             |
| **OAuth + integration install** | Notion → Clerk OAuth proxy auto-binds the worksp