Home

🌐 Language: English | 中文

KinetAios Wiki

Welcome to the KinetAios wiki. This is the feature manual — for users who already installed the app and want to dig into how each feature works.

For project intro (first-time visitors), see the README in the main repo. The wiki doesn't repeat the README — it expands each feature area: how to use + how it works + common questions.

What this is

KinetAios is a local-first AI agent dashboard, cross-platform — Windows 11 and macOS are both first-class (the "Win" folder name is historical). Platform differences (cmd.exe vs /bin/sh, hotkey, tray) are routed at runtime. Run multiple sessions concurrently, stream answers, use shell/file/search/MCP tools, SQLite history + long-term memory, global hotkey, per-session model.

Stack: Electron + TypeScript, better-sqlite3 + FTS5, no frontend framework (vanilla TS + HTML/CSS, bundled with esbuild).

30-second quickstart

git clone https://github.com/phinn/KinetAios.git
cd KinetAios
npm install      # postinstall rebuilds better-sqlite3 for Electron
npm run build
npm start

First launch → top-right ⚙ → fill in the API Key (+ Base URL / model; default GLM Zhipu) → once "Test connection" passes → send a task.

See Getting-Started for details.

Feature matrix

Feature	Entry	Wiki page
Three Direct generations (V1 ReAct / V2 PEVJ / V3 intent router + DAG)	Session header engine selector	Engines · Choose-Engine
V3 deep background jobs + node checkpoints (v3.8.0)	⚙ → "Run complex tasks in background"	Engines
Plugin engines v3 (any CLI agent as plugin:<name>, manifest-only)	Engine dropdown, after installing the plugin	Plugins
Direct engine internals (ReAct, compaction, calibration)	—	Direct-Engine
30+ built-in tools + web_search/web_fetch	Auto-injected	Tools-and-MCP
MCP client + MCP server (remote agent)	🔌 button / config	Tools-and-MCP
Long-term memory + memory graph	🧠 button	Long-Term-Memory
Plugin system v2.2 (tools/panels/hooks)	🔌 Plugins button	Plugins
Skills / Commands / Agents + built-in skills	/ or ⚡ · Settings → Skills	Skills
Pipeline (cross-engine orchestration)	Programmatic	Pipeline
Session branching + export/import	Context menu / MCP	Session-Management
Context inspector + compaction viz	Chat header inspector button	Direct-Engine
File browser + multi-tab preview	🌐 button / "Files" tab	Files-and-Preview
Git status / history / file diff / commit show	"Git" tab	Git-Integration
Project rules + project context	"Rules" tab / Workbench "Context"	Rules-and-Context
Workbench (project card overview)	📂 button	Workbench
Dashboard (cost/token analytics)	📊 button	Dashboard
Town view (remote node visualization)	🏘️ button	Town
Realtime voice chat (Doubao WS)	🎤 in chat	Voice-Chat
Multimodal (image + voice + screenshot)	📎 / 🎤 / 📸 in chat	Multimodal
Global search (all conversations)	Ctrl/Cmd+K	Global-Search
Settings (10 tabs: Model / Appearance / Engine / Advanced / Security / Messaging / Plugins / Skills / Goal / Mesh)	⚙ button	Settings
Global hotkey quick panel	Ctrl/Cmd+Alt+Space	Global-Hotkey
Feishu & WeCom bot integration	Settings → Messaging	Messaging-Bots
Four-language switch	⚙ → Interface → Language	i18n
Architecture overview (main / preload / renderer)	—	Architecture
Dev & packaging (typecheck / build / dist / CI)	—	Development

Conventions

• English is the primary language; Chinese (.zh-CN.md) is a switchable mirror.
• Code identifiers, CLI flags, file names stay in English in both versions.
• Cross-page links use [[Page-Name]] (GitHub wiki auto-renders; file name maps to Page-Name.md).
• Code references use src/path/file.ts:line — clickable in your local repo.
• ponytail: markers in code are deliberate MVP simplifications.

Syncing this wiki to GitHub

The markdown sources live in the main repo's wiki/ directory. To push them to GitHub wiki, see Wiki-Sync.