MCPcopy Index your code
hub / github.com/3xpyth0n/ideon

github.com/3xpyth0n/ideon @v0.9.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.9.4 ↗ · + Follow
1,519 symbols 4,325 edges 418 files 39 documented · 3%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Ideon Logo

The self-hosted visual workspace for your projects.

Organize repositories, notes, links and more on a shared infinite canvas.

Ideon workspace overview Prettier CI Contributions welcome Discord server Last commit License

Overview

Ideon replaces abstract folders with spatial organization. Instead of navigating tabs, you see your entire project context: Git repositories, design notes, and tasks, on a single map.

Home Page | Documentation | Roadmap | Discord Server | About

Features

  • Spatial Canvas: Place blocks anywhere. What is close is related.
  • Live Integrations: Embed repositories and issues directly on the canvas (GitHub, GitLab, Gitea, Forgejo).
  • Rich Media: Support for Markdown notes, images, links, and files.
  • Multiplayer: Real-time collaboration with your team.
  • Time Travel: View historical snapshots of your workspace to trace decisions.
  • Self-Hosted: You own your data.

Demo

Try the hosted demo instantly (no setup required):

  • URL: https://demo.theideon.com
  • User: ideon-demo
  • Pass: ideon-demo

Getting Started

Requires Docker and Docker Compose.

1. Clone the repository (or download docker-compose.yml directly)

2. Copy the environment template and fill in the required values

cp env.example .env

Edit .env and set at minimum SECRET_KEY (generate with openssl rand -hex 32) and any DB credentials you want to change.

3. Start the stack

docker compose up -d

Once running, access the dashboard at: http://localhost:3000

Contributing

If you've ever wanted to contribute to open source, and a great cause, now is your chance!

Bug reports, feature ideas, documentation improvements, and code contributions all matter.

Start here:

Contributors

Creator

Saad Idrissi Saad Idrissi 💻

Code Contributors

Thanks go to these wonderful people:

albanobattistella albanobattistella 🌍 Solirix Solirix 🛡️ floory floory 🐛 Michael Bonfils Michael Bonfils 📖

This project follows the all-contributors specification. Contributions of any kind are welcome!

Project growth over time

Star History Chart

License

AGPLv3.

If you deploy Ideon publicly and modify it, you are expected to share the changes.

Extension points exported contracts — how you extend this code

AuthUser (Interface)
(no doc)
src/auth.ts
ShellSession (Interface)
(no doc)
src/server.ts
Persistence (Interface)
(no doc)
src/lib/y-websocket/utils.ts
Project (Interface)
(no doc)
src/app/components/TabBar.tsx
NamedDoc (Interface)
(no doc)
src/lib/y-websocket/callback.ts
TabBarProps (Interface)
(no doc)
src/app/components/TabBar.tsx
CallbackData (Interface)
(no doc)
src/lib/y-websocket/callback.ts
VersionBadgeProps (Interface)
(no doc)
src/app/components/VersionBadge.tsx

Core symbols most depended-on inside this repo

getDb
called by 118
src/app/lib/db.ts
useI18n
called by 90
src/app/providers/I18nProvider.tsx
addEventListener
called by 79
src/app/lib/chunkedWebSocket.ts
removeEventListener
called by 75
src/app/lib/chunkedWebSocket.ts
tr
called by 71
src/app/components/project/EventModal.tsx
authenticatedAction
called by 61
src/app/lib/server-utils.ts
logSecurityEvent
called by 40
src/app/lib/audit.ts
focusProjectCanvas
called by 38
src/app/components/project/utils/focusCanvas.ts

Shape

Function 1,217
Interface 267
Method 19
Class 16

Languages

TypeScript100%

Modules by API surface

src/app/components/project/KanbanBlock.tsx47 symbols
src/app/components/dashboard/ProjectList.tsx34 symbols
src/app/components/project/hooks/useProjectCanvasState.ts29 symbols
src/app/lib/types/db.ts27 symbols
src/lib/y-websocket/utils.ts21 symbols
src/app/lib/chunkedWebSocket.ts21 symbols
src/app/lib/db.ts20 symbols
src/app/components/project/kanbanModel.ts20 symbols
src/app/lib/integrations/import/service.ts18 symbols
src/app/components/project/CalendarBlock.tsx17 symbols
src/app/lib/client/git-providers.ts16 symbols
src/app/lib/authAdapter.ts16 symbols

For agents

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

⬇ download graph artifact