MCPcopy Index your code
hub / github.com/NPC-Worldwide/incognide

github.com/NPC-Worldwide/incognide @v0.2.22

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.2.22 ↗ · + Follow
5,319 symbols 12,757 edges 183 files 31 documented · 1%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Incognide logo with Levi the dog howling at the moon

Incognide

Explore the unknown and build the future.

License Platforms Release

Download for Linux, macOS, and Windows


Incognide unifies chat, code, documents, web browsing, and media into a tileable workspace with intelligent context and composable automations.

Built for seamless workflows, Incognide eliminates distractions and context switching. A path-based organization keeps your work structured naturally, while auto-saving workspaces let you resume any project exactly where you left off. No more juggling desktops, drowning in browser tabs, or hunting for scattered files.

Highlights

  • Write and run code, use terminals, build reusable workflows and tools that chain together natural language and templateable code through jinja execution templates.
  • Browse the web, read and annotate PDFs, view 3D STL models, analyze data and create dashboards, compile LaTeX.
  • Edit DOCX, XLSX, PPTX.
  • Arrange chats, editors, PDFs, browsers, terminals, 3D viewers as your work evolves — each tab maintains independent state.
  • Manage agents, have them run on scheduled jobs, edit team context, integrate with MCP Servers, approve or reject suggested memories, prune and evolve knowledge graphs.
  • Schedule automated memory extraction, knowledge graph evolution, and context compression.
  • Fine-tune text models using curated data from your conversations and memories.
  • Built-in Pomodoro timer with programmable schedules and break enforcement.

Setup

1. Install

Download the installer for your platform from enpisi.com/incognide, run it, and launch Incognide. Linux, macOS, and Windows are supported.

2. First launch — setup wizard

On first launch the wizard walks you through five steps:

  1. Welcome — intro screen.
  2. Preferences — theme (dark/light) and the data directory for teams, models, and configs (default ~/.incognide).
  3. Defaults — default web search engine, default terminal shell (auto-detected per platform: system/zsh/bash on mac/linux, powershell on Windows), and activity tracking opt-in (local only, used for next-action predictions).
  4. Usage path — pick one of:
  5. No AI — workspace only (files, code, browsers, terminals, docs, maps). No model calls.
  6. Cloud AI — OpenAI / Anthropic / Gemini / etc. via API keys.
  7. Local AI — Ollama / LM Studio / llama.cpp / oMLX running on your machine.
  8. Cloud keys (cloud-ai path) or Local models (local-ai path). See step 3 below for details.

The wizard writes preferences to localStorage (theme, fonts, shortcuts, UI defaults) and settings to ~/.incogniderc .

3. Connect a model provider

Local providers

The setup wizard (Local Models step) and the in-app Model Manager both probe these endpoints and binary locations:

Provider Server port Binary / app checks
Ollama 11434 ollama in PATH; /Applications/Ollama.app on macOS
LM Studio 1234 lms in PATH; /Applications/LM Studio.app on macOS
llama.cpp 8080 llama-server, llama-cli, or koboldcpp in PATH
oMLX 8000 omlx in PATH; /Applications/oMLX.app (macOS only)

Each tile shows one of three states: Running (server responds), Installed (not running) (binary or app found but port is dead), or Not found. The Model Manager has Start/Stop buttons when the binary is installed:

  • Ollama: open -a Ollama (macOS) or ollama serve (Linux). Stop via pkill -f 'ollama serve' (or kill from the Windows system tray).
  • LM Studio: lms server start / lms server stop if the lms CLI is present; otherwise the app launches and you start the server from the Developer tab.
  • llama.cpp: requires a model path to start, so Incognide prints the exact command (llama-server -m <model.gguf> --port 8080) for you to run in a terminal. Stop via pkill -f llama-server.
  • oMLX: open -a oMLX launches the menu-bar app; stop/start the server from its menu-bar icon.

GGUF / GGML model files can be loaded directly without a server, but only if llama.cpp or koboldcpp is installed — the Model Manager's GGUF tab depends on that engine and shows "Not found" otherwise.

Cloud providers

Add API keys on the Cloud keys step of the wizard, or later in Settings → Global Settings or Team Management → API keys. Keys are stored in ~/.incogniderc as export <PROVIDER>_API_KEY=....

4. Local setup for fine-tuning

Inference with LLMs is routed through the bundled backend (including calls to locally running models with llama.cpp, omlx, etc), but users can also fine-tune models within incognide. To accomplish this, you need to specify a Python virtual environment with the heavy packages (torch+ transformers etc.). For such calls, Incognide shells out to the specified venv instead of including these dependencies in the bundled backend to keep the packaged executable small.

  1. Open Team Management (Users icon in the right sidebar or the settings screen).
  2. Go to the Python Env tab.
  3. Choose an environment for the current workspace:
  4. Detected: list of venvs/pyenv/conda/uv environments found under the workspace, homedir, and common paths.
  5. Create new venv: creates <workspace>/.venv (or the name you pick) with the system Python.
  6. Custom path: point at any existing Python interpreter.
  7. With an environment selected, click Install packages and pick one of the bundles:
  8. PyTorch (CPU)torch torchvision torchaudio
  9. PyTorch (CUDA) — same plus the CUDA index URL for GPU builds
  10. Diffusers (Image Gen)diffusers transformers accelerate safetensors
  11. Transformers (LLM)transformers accelerate safetensors sentencepiece
  12. Whisper (Speech)openai-whisper

Or install any specific package by name.

5. Data directory

Incognide stores teams, NPCs, jinxes, memories, knowledge graphs, and model configs under the data directory you picked in step 2 (default ~/.incognide). Changing it in Settings → Global Settings → Default Directory updates ~/.incogniderc's INCOGNIDE_DATA_DIRECTORY.

6. Troubleshooting

  • Backend unhealthy indicator in the status bar — right-click the npcpy icon in the status bar for Restart / View Logs. Logs live in ~/Library/Logs/Incognide/ (macOS), ~/.config/Incognide/logs/ (Linux), or %APPDATA%\Incognide\logs\ (Windows).
  • Tutorial didn't highlight anything — the tutorial opens the Help pane before it starts so the workspace highlight has a target. If it runs before any pane is open you'll see an un-highlighted step; re-run it from Settings → Replay Tutorial.

Table of Contents


Office & Productivity

Document Editing

Create and edit Office documents directly in Incognide without needing external applications or cloud services.

Word Documents (DOCX) - Full rich text editing with formatting, tables, and images:

DOCX and XLSX Editing

Spreadsheets (XLSX & CSV) - Edit data with formula support and cell formatting:

CSV Editing

Presentations (PPTX) - View and edit PowerPoint presentations:

PPTX Editing

PDF Management

Read, annotate, and analyze PDF documents with AI assistance.

Highlight & Annotate - Mark up PDFs with highlights that persist across sessions:

PDF Highlighting

PDF Library - Browse and organize your PDF collection:

PDF Library

File Management

Folder Explorer - Drag any folder from the sidebar into a pane to open a dedicated file browser:

Folder contents

Disk Usage Analyzer - Visualize what's taking up space on your drives:

Disk usage

Web Browsing

Browse the web alongside your documents and chat with AI about what you're viewing.

Integrated Browser - No need to switch to a separate browser window:

AI Web Browsing

Tileable configuration - Browse while viewing PDF with a terminal open and a chat window:

Tiled PDF Browser


Development

Code Editing

Write code with syntax highlighting, run scripts, and compile documents.

Code Editor and script execution - Syntax highlighting for Python, JavaScript, TypeScript, and more. Vim, Emacs, and Nano keybinding modes with a toggleable cheat sheet. Run Python scripts directly and see output inline:

script execution

LaTeX Compilation - Write and compile LaTeX documents with PDF generation launching a pane.

latex compilation

AI-Assisted Development

File Analysis - Select files and ask AI to analyze, explain, or refactor code:

Analyze Files

Database Tools

Connect to databases, explore schemas, and run queries.

Schema Viewer and SQL Querying - Investigate your database structure, write queries manually or with natural language.

Database Schema

Manipulate table results and plot data directly for quick analysis:

Database Query

Git Integration

Git Manager - Stage, commit, and manage branches without leaving Incognide:

git manager


STL Viewer

View 3D models directly in Incognide.

Features: - Orbit, pan, and zoom with mouse controls - Wireframe, axes, and grid toggles in the pane header - Quick axis views (X, Y, Z) for front/side/top perspectives - Adjustable mesh color and opacity - Screenshot export of the current viewport - Model info: triangle count, vertex count, and bounding box dimensions


Research & Knowledge Management

Data Analysis

Build dashboards and visualizations from your data.

Data Dashboard - Composable widgets for analytics and visualization:

Data Dashboard

Knowledge Graphs

Explore connections between concepts and entities.

Graph Explorer - Navigate and edit knowledge graphs built from your conversations:

Knowledge Graph

Memory & Context

Memory Management - Review, edit, and organize what your agents remember:

Memory CRUD

Agent Memories - See what context agents have learned from conversations:

Agent memories


Model Training & Fine-tuning

Train custom AI models using your own data—no coding required. Incognide provides first-class UI for curating training data from your conversations and memories, then fine-tuning models locally.

Text Model Training

Fine-tune language models using curated subsets of your AI interactions and memories.

Data Curation - Select specific conversations, memories, and agent interactions to use as training data:

Features: - Browse and filter your conversation history - Select individual messages or entire conversations for training - Export agent memories

Extension points exported contracts — how you extend this code

Window (Interface)
(no doc)
src/renderer/components/electronFileApi.ts
Highlight (Interface)
(no doc)
tests/unit/pdfExport.test.ts
UserMenuProps (Interface)
(no doc)
src/renderer/components/UserMenu.tsx
PdfDrawing (Interface)
(no doc)
tests/unit/pdfExport.test.ts
PicViewerProps (Interface)
(no doc)
src/renderer/components/PicViewer.tsx
JobConfig (Interface)
(no doc)
src/renderer/components/CronDaemonPanel.tsx
CronDaemonPanelProps (Interface)
(no doc)
src/renderer/components/CronDaemonPanel.tsx

Core symbols most depended-on inside this repo

log
called by 280
src/main.js
getFileName
called by 138
src/renderer/components/utils.tsx
dbQuery
called by 131
src/main.js
generateId
called by 94
src/renderer/components/utils.tsx
qNS
called by 90
src/renderer/components/PptxViewer.tsx
registerAction
called by 72
src/renderer/studioActions/index.ts
getColumnIndex
called by 59
src/renderer/utils/passwordImport.ts
findNodePath
called by 44
src/renderer/components/utils.tsx

Shape

Method 2,221
Function 1,835
Class 1,095
Interface 168

Languages

TypeScript98%
Python2%

Modules by API surface

public/pdf.worker.min.js3,500 symbols
src/renderer/components/Enpistu.tsx93 symbols
src/renderer/components/Sidebar.tsx91 symbols
src/main.js69 symbols
src/renderer/components/utils.tsx50 symbols
src/ipc/settings.js41 symbols
src/renderer/studioActions/dataActions.ts38 symbols
src/renderer/components/MessageLabeling.tsx38 symbols
src/renderer/components/ExpViewer.tsx37 symbols
src/renderer/components/CtxEditor.tsx35 symbols
src/renderer/components/NPCTeamMenu.tsx29 symbols
src/renderer/components/PdfViewer.tsx28 symbols

Datastores touched

(mysql)Database · 1 repos
dbDatabase · 1 repos
dbDatabase · 1 repos

For agents

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

⬇ download graph artifact

Ask about this repo answers extend the page