hub / github.com/ThinkEx-OSS/thinkex

github.com/ThinkEx-OSS/thinkex @v1.0.0

repository ↗ · DeepWiki ↗ · release v1.0.0 ↗ · + Follow

917 symbols 2,499 edges 261 files 64 documented · 7%

What it actually does AI analysis from the code graph — generated when you open this

loading…

README

Today’s AI chat interfaces make long-term and complex work frustrating: context gets lost, ideas scatter, and information overload builds over time. ThinkEx raises the standard with a flexible workspace designed to capture what's relevant, organize knowledge, and use AI without losing control.

Head over to thinkex.app to start using ThinkEx right away, no setup required.

Tech Stack

Framework: Next.js
Styling: Tailwind CSS, Shadcn UI
Database: PostgreSQL with Drizzle ORM
State & Data: TanStack Query, Zustand

Self-Hosting

Want to run ThinkEx on your own infrastructure? Follow these steps.

Prerequisites

Node.js (v20+)
pnpm
PostgreSQL database (local or hosted like Supabase/Neon)

Installation

Clone the repository: bash git clone https://github.com/yourusername/thinkex.git cd thinkex
Install dependencies: bash pnpm install
Environment Setup: Duplicate the example environment file and configure your keys. bash cp .env.example .env.local
- Add your DATABASE_URL
- Add your GOOGLE_CLIENT_ID / SECRET (for Auth)
- Add your AI API keys (e.g., GOOGLE_GENERATIVE_AI_API_KEY)
Database Setup: Push the schema to your database. bash pnpm db:push
Run the development server: bash pnpm dev

Open http://localhost:3000 to see the app.

Contributing

We welcome contributions! Please follow these steps:

Fork the repository.
Create your feature branch: git checkout -b feature/amazing-feature.
Commit your changes: git commit -m 'Add some amazing feature'.
Push to the branch: git push origin feature/amazing-feature.
Open a Pull Request.

Acknowledgments

Special thanks to the following open-source projects that power key features of ThinkEx:

License

This project is licensed under the MIT License - see the LICENSE file for details.

Extension points exported contracts — how you extend this code

SidebarItemButtonProps (Interface)

* Sidebar item button component with hover menu (for nested items)

src/components/workspace/SidebarCardList.tsx

RichContent (Interface)

* Extracts rich content (images, math) from BlockNote JSON blocks * Returns arrays of image URLs and LaTeX expressions

src/lib/utils/format-workspace-context.ts

AssistantAvailabilityContextType (Interface)

* Context to indicate whether the AI assistant is available * Used by hooks like useCardContextProvider to skip AI-rela

src/contexts/AssistantAvailabilityContext.tsx

SharedWorkspaceData (Interface)

(no doc)

src/app/share/[id]/page.tsx

TextSelectionHandlers (Interface)

(no doc)

src/hooks/workspace/use-text-selection-agent.ts

SidebarRootItemProps (Interface)

* Root-level sidebar item component with hover menu (for items not in folders)

src/components/workspace/SidebarCardList.tsx

UIState (Interface)

* UI Store - Manages all UI state (chat, modals, search, layout, text selection) * This replaces scattered useState hoo

src/lib/stores/ui-store.ts

WorkspaceContextType (Interface)

* Simplified WorkspaceContext - ONLY manages workspace list * * State management responsibilities: * - Workspace lis

src/contexts/WorkspaceContext.tsx

Core symbols most depended-on inside this repo

error

called by 257

src/lib/utils/logger.ts

src/lib/utils/logger.ts

warn

called by 35

src/lib/utils/logger.ts

add

called by 25

src/lib/attachments/supermemory-composite-adapter.ts

createEvent

called by 18

src/lib/workspace/events.ts

useWorkspaceState

called by 16

src/hooks/workspace/use-workspace-state.ts

focus

called by 15

src/components/editor/MathEditDialog.tsx

Shape

Function 748

Interface 141

Method 22

Class 6

Languages

TypeScript100%

Modules by API surface

src/components/assistant-ui/thread.tsx28 symbols

src/components/ui/sidebar.tsx25 symbols

src/lib/utils/format-workspace-context.ts19 symbols

src/lib/stores/ui-store.ts18 symbols

src/lib/utils/text-highlighter.ts15 symbols

src/components/ui/dropdown-menu.tsx15 symbols

src/components/ui/context-menu.tsx15 symbols

src/components/assistant-ui/thread-list-dropdown.tsx15 symbols

src/lib/utils/logger.ts14 symbols

src/components/chat/AppChatHeader.tsx14 symbols

src/components/ai-elements/model-selector.tsx14 symbols

src/lib/workspace-state/types.ts13 symbols

For agents

$ claude mcp add thinkex \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

github.com/ThinkEx-OSS/thinkex @v1.0.0

Tech Stack

Self-Hosting

Prerequisites

Installation

Contributing

Acknowledgments

License

Extension points exported contracts — how you extend this code

Core symbols most depended-on inside this repo

Shape

Languages

Modules by API surface

For agents

Ask about this repo answers extend the page