GitHub - ThinkEx-OSS/thinkex: Study and research with your docs, media, and AI in one place

ThinkEx

The workspace built for how you study, research, and create.

When a Chat Thread Is Not Enough

ThinkEx is a workspace for source-heavy study and research.

Instead of uploading sources into a chat, you keep the actual materials in view: PDFs, notes, images, folders, and AI chat. Arrange them, pick what the AI should use, and keep the answer tied to the workspace where the work is happening.

Open PDFs, documents, images, notes, and folders in a workspace.
Put sources side by side while you read or compare them.
Ask AI about the specific items you choose.
Share a workspace with collaborators (fellow humans).

How It Is Different

Need	Common tradeoff	ThinkEx
Organize the work	Sources live across chats, tabs, folders, and note apps	One workspace holds sources, notes, folders, and AI chat
Work with the source	Uploaded files become something you query, not arrange	PDFs, documents, images, and notes stay open and usable
Control AI context	Long sessions rely on pasted context or hidden retrieval	You choose the workspace items the AI should use
Keep place and context	Answers get separated from the source page or document	Source context stays next to the notes and questions
Work with other people	Personal chats and local notes are hard to share	Collaborators use the same organized workspace

What's In This Repo

This is the current ThinkEx web app. It uses React, TanStack Start, TypeScript, Tailwind CSS, Better Auth, Drizzle, Tiptap, Yjs/PartyServer, EmbedPDF/PDFium, and Cloudflare Workers.

Most product code lives in src/features/workspaces/. Runtime and deployment configuration lives in wrangler.jsonc, with database migrations in drizzle/.

For deeper implementation notes, see docs/ARCHITECTURE.md and docs/ENVIRONMENT.md.

Local Development

With Infisical:

pnpm install --frozen-lockfile
pnpm dev

Without Infisical, you can run with .dev.vars:

pnpm install --frozen-lockfile
cp .dev.vars.example .dev.vars
pnpm serve:dev

The app runs at http://localhost:3000. Only BETTER_AUTH_SECRET and BETTER_AUTH_URL are required for the core local app; optional secrets unlock features such as AI chat, browsing, and email.

Useful commands:

pnpm serve:dev starts the local dev server with existing environment variables or .dev.vars.
pnpm db:migrate:local applies local D1 migrations before first database use.
pnpm check runs the fast TypeScript/lint validation.
pnpm verify runs the full validation suite.

Notes:

Node >=22.18 is required.
Docker must be running because the app declares Cloudflare Container bindings.
If you are not logged into Cloudflare locally, run with CLOUDFLARE_VITE_FORCE_LOCAL=true pnpm serve:dev.

Contributing

Issues and pull requests are welcome. Start with CONTRIBUTING.md, keep changes focused, and run pnpm verify before opening a PR when possible.

License

ThinkEx is licensed under the AGPL-3.0 License.