Skip to content
sabique-islamPublic

About

one workspace for notes, documents, on-device lecture transcription, and whiteboards. collaborate or keep everything local on your device.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

14 stars

Watchers

0 watching

Forks

Latest commit

 

History

449 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
Wings

Wings

Notes with nested pages, LaTeX math, Excalidraw drawings, on-device lecture transcription, a local vault, and a BYOK AI panel.

Vercel deploy React TypeScript Vite Supabase TipTap Bun License: AGPL-3.0

Live · Discord


Wings Banner

Features

  • Nested pages and a TipTap editor with slash commands
  • Lecture Mode: record from the mic, transcribe on-device (Whisper), append a timestamped transcript to the open page. first run downloads the model; after that it stays cached in the browser
  • LaTeX math and Excalidraw drawings in the same note
  • BYOK AI panel (⌘J) with page context; keys stay in the browser
  • Chat renders Mermaid diagrams with preview/source, expand, copy and download, using the editor's existing Markdown, math and code renderers.
  • In notes, use /mermaid (or /diagram) to insert a rendered diagram, or paste a fenced mermaid block. The preview appears above its editable source, supports expansion, and also renders in shared read-only notes.
  • Copying a rendered Mermaid SVG preserves it as a diagram image when editable source is absent; surrounding text, tables and annotated math stay together. For flattened ChatGPT copies, including Markdown-escaped CSS, Wings can rebuild a flowchart from an immediately preceding table's explicit Edge column when all copied node labels match. Rebuilt diagrams are labeled with their source; other source-less copies show a missing-diagram marker.
  • Attach files by picking, pasting or dropping them into chat: images, PDFs, text/code, CSV, DOCX, PPTX, XLSX and OpenDocument text. Images and readable document text stay in the conversation for follow-up questions. Audio/video have local playback; other files have download cards.
  • Chat attachments stay in memory for the current session. Up to 5 files, 25 MB each (images: 10 MB), 50 MB total per message. Text extraction is capped at 40,000 characters per file and 100 PDF pages, with partial/unreadable files labeled. Scanned PDFs need OCR; audio/video and unknown binaries are preview-only, and their contents are not sent to the AI.
  • Public share links and email invites
  • Local vault: new pages can keep bodies on device (connected folder) [or opt for cloud storage too :)]
  • Account backup: zip download and folder import
  • Markdown / JSON export and local draft cache
  • Guards against empty overwrites of substantial notes
  • Plugins and remote MCP access: search, read, create, and edit your pages from ChatGPT, Claude, or another MCP client

History

Notion workspace limit

i hit notion's limits in feb 2026. not on blocks (free tier gives you unlimited workspace blocks until you share), but shared workspace usage and the ai quota. needed more of both, so i threw this together on lovable.

friends liked it :) i still work on it occasionally, fixing bugs or adding features as requested or if i feel the lack of something.

migrated from lovable to a personal stack in july 2026.


Plugins

Wings includes Wings Notes, a ChatGPT plugin for searching, reading, creating, and editing your own pages. The plugin package contains its listing, icon, review cases, and remote MCP configuration. See the packaging instructions to build the ZIP. The package connects to the hosted Wings server; it does not need a local MCP process.

You can connect directly with the steps below without waiting for a public directory listing.

Connect an MCP client

Use this remote MCP server URL (Streamable HTTP):

https://wings.nopejs.me/api/mcp

ChatGPT

  1. Open ChatGPT on the web and go to Plugins → + → Add custom MCP server. Depending on your account, this may appear under Settings → Apps → Advanced settings → Developer mode.
  2. Enter Wings Notes as the name and paste the server URL above.
  3. Choose OAuth. If asked for a registration method, select DCR (dynamic client registration); no client ID or client secret is needed.
  4. Review the connection notice, create and install the plugin, then sign in to Wings when prompted.
  5. On the Wings consent screen, approve read access. Enable write access if you want ChatGPT to create or edit pages.
  6. Select Wings Notes in a conversation and try: “Which of my pages did I edit most recently?”

Custom MCP availability depends on your ChatGPT account and workspace permissions. See OpenAI's connection guide.

Claude

  1. Open Customize → Connectors → + Add → Add custom connector. In some interfaces, connectors appear under Settings → Connectors; managed workspaces use Organization settings → Connectors → Add → Custom → Web.
  2. Enter Wings Notes and the same server URL.
  3. Use OAuth and choose Register automatically if asked how to identify the OAuth client. Connect and sign in to Wings. Approve read access, plus write access if you want to create or edit pages.
  4. Enable the connector in your conversation and ask Claude to find or summarize a page.

On managed workspaces, an administrator may need to add or allow the connector first. See Claude's custom connector guide.

Other MCP clients

For clients that accept a bearer token, create a personal access token in Wings under Settings → Access, then configure the same URL with this header:

Authorization: Bearer <personal access token>

Tokens start with wings_pat_ and default to read-only. Enable write access when creating a token if the client should create or edit pages. Keep the token in your client's private settings, not in a committed configuration file.

Access and limits

  • Tools: list_pages, get_page, search_pages, create_page, update_page, and append_to_page.
  • Only pages you own are accessible; pages shared with you by other people are excluded.
  • Local-vault bodies stay on your device and are not returned by the API.
  • Pages with live collaboration history can be read but cannot be rewritten through the API. There is no delete tool.
  • Revoke a token or connected app from Settings → Access in Wings.

The endpoint accepts POST requests. Opening it in a browser normally returns “Method not allowed”; that alone does not indicate a failed connection. More details: Wings docs.

For self-hosting, apply supabase/migrations/20261020190000_api_access.sql and set API_TOKEN_PEPPER, SUPABASE_URL, SUPABASE_PUBLISHABLE_KEY, SUPABASE_SERVICE_ROLE_KEY, and API_PUBLIC_ORIGIN to your deployment's HTTPS origin. Use that deployment's /api/mcp URL in your client. Those values stay out of git.

Development

cp .env.example .env   # fill Supabase and related keys
npm install --legacy-peer-deps
npm run dev

CI and some scripts use Bun (bun run test:ci). Local day-to-day works with npm.

More setup: .github/LOCAL_SETUP.md · CONTRIBUTING.md


License

GNU Affero General Public License v3.0 or later (AGPL-3.0).

Contributing

See CONTRIBUTING.md.


About

one workspace for notes, documents, on-device lecture transcription, and whiteboards. collaborate or keep everything local on your device.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

14 stars

Watchers

0 watching

Forks

Sponsor this project

Contributors

Languages