KinetAios

KinetAios

English | 简体中文

🌐 Sitio web → https://phinn.github.io/KinetAios/

Sesión real: conversaciones paralelas entre proyectos, insignia de motor por sesión (Direct / Claude Code / Codex), pestañas de archivos, Git y reglas, contabilidad de costo por tokens por turno.

Un panel de agente de IA local-first para Windows 11 y macOS — ambas plataformas de primera clase (el nombre de la carpeta "Win" es histórico; el repositorio es phinn/KinetAios). Las diferencias de plataforma (cmd.exe vs /bin/sh, tecla de acceso rápido, bandeja) se enrutan en tiempo de ejecución; las funciones están alineadas en ambos lados. Ejecuta múltiples sesiones de agente simultáneamente con respuestas en streaming, herramientas de shell/archivos/búsqueda/MCP, historial SQLite con memoria a largo plazo, una tecla de acceso rápido global y un modelo por sesión. Sin cuenta, sin servidor de retransmisión — tu propia clave de API LLM es la única credencial.

La versión de 30 segundos:

• 🔀 Cuatro motores, una ventana — Direct (ReAct interno) + Claude Code + Codex + DeepSeek Harness; cambia por sesión, transfiere contexto vía Pipeline
• 🧠 Memoria a largo plazo en SQLite local — hechos extraídos automáticamente compartidos entre todos los motores, sobrevive a reinicios
• 🔒 Local-first, sin cuenta — tu clave de API es la única credencial; nada pasa por un retransmisor
• 🛠 Más de 30 herramientas integradas + cliente/servidor MCP + plugins — shell, archivos, web, capturas de pantalla, uso de computadora listos para usar
• ⌨️ Panel rápido con tecla de acceso global — Spotlight para agentes de IA, invocable desde cualquier lugar
• 📊 Evaluado en una tarea empresarial real de 400k filas — motor interno 9.2 vs Claude Code 7.0 (informe completo)
• 🖥 Windows 11 y macOS — ambas de primera clase

⭐ Si KinetAios te ahorra tiempo, una Estrella es el agradecimiento más sonoro para un proyecto open-source en solitario.

---

¿Por qué KinetAios?

La mayoría de los clientes de IA te encierran en un proveedor, pierden contexto al cambiar de motor y enrutan tus conversaciones a través de un retransmisor. KinetAios ejecuta cuatro motores en una ventana, mantiene memoria a largo plazo entre todos ellos y nunca pide una cuenta.

	KinetAios	Claude Desktop	Cherry Studio	Cursor	Codex Desktop
Cuatro motores (Direct V1/V2/V3 + Claude Code + Codex + DeepSeek Harness)	✅	—	—	—	—
SQLite local + memoria a largo plazo automática	✅	—	—	—	—
Memoria entre motores (un perfil de usuario compartido por todos los motores)	✅	—	—	—	—
Múltiples sesiones paralelas	✅	—	✅	—	✅
Tecla de acceso global + panel rápido	✅	—	—	—	—
Escaneo automático de MCP / Skills / Agents	✅	✅	—	—	—
Reglas de proyecto (AGENTS / CLAUDE / KINET)	✅	—	—	✅	✅
Servidor MCP integrado (control remoto de agentes)	✅	—	—	—	—
Sistema de plugins (herramientas / paneles / comandos de barra)	✅	—	—	—	—
Multimodal (entrada de imagen + voz + capturas de pantalla)	✅	✅	—	—	—
Ramificación de sesiones + orquestación Pipeline entre motores	✅	—	—	—	—
Local-first, sin cuenta	✅	✅	✅	—	—

Instalación

Obtén la última versión:

• Windows — KinetAios-Setup-<version>.exe (instalador NSIS)
• macOS — consulta versiones

Compilaciones sin firmar → Windows SmartScreen / macOS Gatekeeper advertirán; permítelo manualmente.

Primer lanzamiento: haz clic en ⚙ en la esquina superior derecha → pega tu Clave de API (+ URL base / modelo, por defecto GLM/Zhipu) → haz clic en Probar conexión, luego envía tu primera tarea.

🐋 ¿Una clave para cada modelo? Elige el ajuste preestablecido OrcaRouter — una puerta de enlace compatible con OpenAI con más de 200 modelos, enrutamiento adaptativo, sin margen. Regístrate con este enlace para apoyar el proyecto (5% de crédito de referencia).

Ajuste preestablecido OrcaRouter integrado:

provider: orcarouter          # Settings → Presets → OrcaRouter (multi-model routing)
protocol: openai              # OpenAI-compatible
base_url: https://api.orcarouter.ai/v1
api_key: sk-orca-...          # create in the OrcaRouter console
model: orcarouter/auto        # adaptive routing, or pin a vendor/model e.g. anthropic/claude-opus-4.8

Desde el código fuente

Requiere Node.js 18+ y una conexión de red (el módulo nativo better-sqlite3 necesita compilación).

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

---

Destacados

Cuatro motores, intercambiables por sesión

• Direct V1 (Kaios) — bucle ReAct integrado con un proveedor de doble protocolo (compatible con OpenAI y Anthropic, ambas direcciones de streaming SSE), concurrencia a nivel de herramientas, subagentes, compactación de contexto y reintentos.
• Direct V2 — ReAct de próxima generación sobre una arquitectura Plan-Execute-Verify-Judge, llamadas a herramientas en streaming, listas de tareas paso a paso renderizadas en vivo en el chat como tarjetas de verificación, más un bucle de ejecución unificado compartido por plan y replan (reintento / verificación / puntos de control / compactación se comportan idénticamente en ambas rutas).
• Direct V3 — lo más reciente: un enrutador de intención elige fast / standard / deep por consulta; la ruta deep construye llamadas a herramientas en un DAG de dependencias y lo ejecuta en paralelo — aceleraciones reales en tareas de múltiples pasos.
• Claude Code — inicia claude -p --output-format stream-json, analiza NDJSON, reanuda con --resume.
• Codex — inicia codex exec --json, analiza JSONL, reanuda.
• DeepSeek Harness (3.0+) — inicia la CLI dsh sobre SSE compatible con OpenAI con proveedores integrados OpenAI / Pi-AI, reintentos y facturación de tokens. Intercambiable por sesión como cualquier otro motor.

Más de 30 herramientas integradas

shell (confirmar antes de ejecutar; guardia de enfoque — si un comando roba el primer plano, se devuelve automáticamente), read_file, write_file, edit_file (reemplazo exacto), grep, glob, web_fetch (guardia SSRF + respaldo Jina Reader), web_search (Bing → respaldo DuckDuckGo), recall_memory, git_diff (solo lectura, sin confirmación), remember_fact / recall_fact (anclas de sesión), memory_replace / memory_append (bloques de memoria central), dispatch_agent (subagente de solo lectura con su propio contexto), spawn_team / team_broadcast / team_send / team_close (equipos multiagente), video_gen (MiniMax H3 texto a video), todo_write (lista de tareas compartida, renderizada en vivo como tarjetas de verificación), y más.

Uso de computadora (nativo, cero dependencias externas)

• screenshot (con hide_self — la propia ventana del agente se vuelve transparente durante la captura, cero robo de enfoque), screenshot_window (captura cualquier ventana por título — incluso las ocluidas/en segundo plano, sin cambiar de escritorio).
• mouse_click / mouse_scroll / mouse_drag, keyboard_type / keyboard_key — las coordenadas se convierten del espacio de píxeles de la última captura al espacio de acción de la plataforma (consciente de DPI / origen de ventana, con caducidad por obsolescencia).
• Respaldado por Electron desktopCapturer + PowerShell (Windows) / cliclick (macOS) / xdotool (Linux). En macOS, open desnudo se reescribe mecánicamente a open -gj — el agente nunca roba tu primer plano.

Integración MCP (cliente + servidor)

• Cliente: el motor Direct se conecta automáticamente a servidores MCP configurados en tu sistema (escanea ~/.claude.json, ~/.codex/config.toml, Claude Desktop). Transporte stdio, reconexión automática después de caídas inesperadas. El botón 🔌 muestra servidores/herramientas conectados.
• Servidor: un servidor MCP integrado (HTTP+SSE) expone una herramienta run_agent — máquinas remotas pueden invocar tu agente local completo. Autenticación por token (comparación de tiempo constante), tiempo de espera de 5 minutos, detección de conexiones zombi.

Memoria a largo plazo + grafo de memoria

• En cada turno, se extraen en segundo plano "hechos sobre el usuario" duraderos → SQLite → se inyectan en el siguiente turno. Compartidos entre motores y sesiones.
• Visualización de grafo de memoria: grafo dirigido por fuerzas de procedencia de memoria, detección de conflictos, línea de tiempo. Ventana independiente a pantalla completa.
• Importar/exportar memorias como JSON (respaldo o migración).

Skills / Comandos / Agents / Plugins

• Escanea las skills + comandos + agents de Claude Code y las skills de Codex. Invoca a través del menú / o el botón ⚡.
• Panel de Skills (Configuración → Skills): agrega skills de todas las fuentes de terceros más contribuciones de plugins, con búsqueda, visualización y edición directa de la fuente (skills de plugins de solo lectura). Los cambios surten efecto de inmediato.
• Plugin SDK v3: los plugins contribuyen herramientas, comandos de barra, hooks y paneles a pantalla completa. Inyectados bajo demanda (la coincidencia de palabras clave ahorra ~60% de tokens). 21 plugins integrados: suite de oficina, lluvia de ideas (Excalidraw), práctica de matemáticas, aprendizaje de C++, baja altitud (drones), una suite integrada e IoT (arduino-dev / platformio-dev / serial-comm / modbus-dev / mqtt-dev / ble-dev / ota-dev / sensor-lookup / logic-analyzer / hw-diag), nestjs-dev, deepseek-harness, claude-code, codex, marketing-kit (investigación de marketing: competidores / SEO / embudo / minería de reseñas de aplicaciones + un panel de consola de marketing), y más.

Barra lateral (de izquierda a derecha)

• ＋ nueva sesión.
• 📂 Workbench — tarjetas de proyecto agrupadas por cwd, cada una mostrando actividad reciente + costo. Un botón "Contexto" edita KINET-CONTEXT.md.
• Estado de sesión en vivo — las sesiones en ejecución muestran el paso actual del motor (ejecutando herramienta / reintentando / compactando) justo debajo del título en la barra lateral, sin necesidad de abrir el canal.
• 📊 Dashboard — ventana independiente con uso de tokens en vivo, estadísticas de costo, distribución de motores.
• 🌐 Archivos — navegación de archivos + vista previa <webview> (HTML/SVG/PNG/JPG/PDF) + editor. Multi-pestaña. La barra de direcciones acepta file:// / http(s):// / localhost:<port>.
• 🏘️ Town — visualización isométrica estilo juego de nodos remotos (otras instancias de KinetAios) en tu red.
• 🧠 Memoria — panel de memoria: canal actual / todos, edición/eliminación en línea, procedencia.
• 🔌 Plugins — gestión de plugins: habilitar/deshabilitar, buscar y filtrar, tarjetas de categorías.
• ⚙️ Configuración — ver abajo.

Pestañas de la ventana principal (Chat / Archivos / Git / Reglas)

• Chat — salida en streaming, pasos de herramientas plegables, conteos de tokens en vivo, inspector de contexto, capturas de pantalla, entrada de voz.
• Archivos — igual que 🌐, siguiendo el cwd de la sesión actual.
• Git — git status (izquierda) + git log (derecha). Haz clic en un archivo modificado → diff lado a lado; haz clic en un commit → git show unificado.
• Reglas — edita KinetAios.md en el cwd (reglas a nivel de proyecto, inyectadas en el prompt del sistema).

Pipeline (orquestación entre motores)

Encadena múltiples etapas, cada una con su propio motor + prompt. La salida de la etapa anterior se antepone al prompt de la siguiente etapa. Sondeo de tiempo de espera de 2 minutos por etapa, abortar en caso de fallo.

Ramificación de sesiones y transferencia

• Rama desde cualquier turno — copia profundamente turnos/pasos en una nueva sesión.
• Exportar/importar sesiones — serializa el estado completo de la sesión (turnos + historial + motor + modelo + cwd) para transferencia entre máquinas. La exportación redacta automáticamente secretos (claves de API, contraseñas → [REDACTED]).
• Referencias entre sesiones — vincula sesiones relacionadas, visualizadas como un DAG.

Gestión de contexto (motor Direct)

• Inspector de contexto — ver/editar el array directHistory de cada sesión (editor JSON).
• Compactación automática — cuando el historial excede el presupuesto de tokens, los turnos tempranos se resumen mediante el LLM. Los eventos de compactación se visualizan (tokens antes vs después).
• Calibración por protocolo — las proporciones token/carácter se rastrean por separado por protocolo de API (OpenAI vs Anthropic) para que las sesiones concurrentes no interfieran.

Multimodal (motor Direct)

• Entrada de imagen: 📎 seleccionar/pegar imágenes → partes de contenido de visión → formato OpenAI image_url o base64 de Anthropic.
• Transcripción de voz: 🎤 grabar → Whisper → llena el cuadro de entrada.
• Chat de voz en tiempo real: 🎤 → Volcengine Doubao WebSocket de voz bidireccional — TTS natural, transcripción en vivo, ejecución paralela de herramientas del agente. Consulta la wiki de chat de voz.
• Capturas de pantalla: 📸 superposición → arrastra una región → imagen recortada inyectada en el prompt.

Búsqueda global

Ctrl/Cmd+K superpone una búsqueda en todas las sesiones — coincidiendo con texto de prompts, texto de respuestas y salida de herramientas.

Configuración (⚙️)

• Diseño de dos columnas: navegación por pestañas vertical a la izquierda (Modelos / Apariencia / Motores / Avanzado / Seguridad / Mensajes / Plugins / Habilidades / Objetivo / Multi-máquina), desplazamiento independiente a la derecha; las ventanas estrechas recurren a pestañas horizontales; un cuadro de búsqueda filtra en todos los paneles.
• Proveedores: protocolos OpenAI / Anthropic, URL base, modelo, clave. Ajustes predefinidos de GLM / DeepSeek / OrcaRouter / OpenAI / Anthropic. Botón de verificación de saldo de Zhipu. Almacenamiento cifrado mediante safeStorage.
• Seguridad: puerta de privacidad (detecta datos sensibles que salen de la máquina).
• Comportamiento: modo de aprobación de shell, nivel de sandbox, modo de plan, alternancias del motor CLI, comportamiento al cerrar la ventana (salir / minimizar / bandeja).
• Precios: precios de entrada/salida por modelo para el cálculo de costos.
• Interfaz: idioma (English / 简体中文 / 繁體中文 / 日本語), tema (oscuro / claro, vista previa en vivo).
• Memoria a largo plazo: exportar/importar JSON.

Varios

• Modelo por sesión (menú desplegable editable, protocolo dual compatible con OpenAI + Anthropic).
• Archivos adjuntos: 📎 seleccionar/arrastrar múltiples archivos de texto (los archivos grandes se leen solo con el encabezado), @path referencias a archivos del directorio de trabajo.
• KinetAios.md / AGENTS.md / CLAUDE.md — los archivos de reglas en el directorio de trabajo se inyectan automáticamente en el prompt del sistema.
• Bandeja + atajo global Ctrl/Cmd+Alt+Space → panel rápido.
• Modo compacto: metadatos por turno (duración / tokens / costo) ocultos por defecto, mostrados al pasar el cursor sobre el mensaje; las rutas de archivo reales en la salida de herramientas son clicables para abrir.
• Verificación de actualizaciones contra GitHub Releases, mostrada en la página Acerca de.
• Marca configurable (brand.json), almacenamiento cifrado de claves API (safeStorage: macOS Keychain / Windows DPAPI).

---

Evaluaciones comparativas: cuatro motores, una tarea empresarial real

El mismo análisis cruzado de CRM de dispositivos médicos con 400k filas (multi-hoja × nivel de hospital × ventana de tiempo, que produce un informe interactivo de ECharts) — cuatro motores, prompt idéntico, cero intervención humana:

Motor	Puntuación /10	Tokens	Diferencia clave
Directo (interno)	9.2	1.31M	SAX-streaming nativo de xlsx — el archivo nunca entra en el contexto
Claude Code	7.0	~2M	Gran gestión de contexto, pero sin herramientas de plugins — cada paso se desvía a través de Bash+python
Codex	5.5	~2.4M	Diseño centrado en sandbox, no adecuado para tareas de datos interactivas
PEVJ V2 (interno)	3.5	3.8M+	Arquitectura de cuatro capas sin salvaguardas en la verificación = amplificador de tokens

El hallazgo más valioso: el 7.5% de las llamadas API consumió el 63% del presupuesto. La causa raíz no fue el modelo — fue el diseño de herramientas. El agente leyó el mismo archivo grande 16 veces secuencialmente, reenviando el historial completo en cada pasada. Cambiar a un lector de streaming eliminó ese costo.

Informe completo: metodología + puntuaciones por dimensión + trazas paso a paso — incluye todos los detalles minuciosos del 3.5 de nuestro propio motor.

---

Pila tecnológica

• Electron + TypeScript — el proceso principal ejecuta el runtime del agente; el renderizador es una interfaz web nativa.
• better-sqlite3 — SQLite + FTS5 (historial / recall_memory búsqueda de texto completo + recuperación semántica por embeddings).
• Sin framework de frontend — el renderizador es TS vanilla + HTML/CSS, empaquetado con esbuild.

Estructura del proyecto

KinetAios/               # repo root (the "Win" dir name is historical — it's the cross-platform repo now)
  brand.json               # branding config (product name etc., read at startup)
  package.json
  src/
    shared/types.ts         # types + applyEvent (shared by main/renderer, single source of truth)
    shared/i18n.ts          # four-language string table + t()
    main/
      main.ts               # windows / tray / hotkey / IPC / shell-confirm bridge
      TaskManager.ts        # session management + engine dispatch + memory extraction
      engines.ts            # Engine interface + Direct/ClaudeCode/Codex + cross-platform CLI spawn
      AgentLoop.ts          # ReAct loop (Direct) + history compaction + auto-shrink
      V3/                   # Direct V3: intent router + fast/deep paths (deep = DAG parallel)
      glm.ts                # providers + OpenAI/Anthropic SSE streaming + retries
      updater.ts            # GitHub Releases update check
      tools.ts              # 30+ built-in tools + computer-use glue + focus guard
      computer-use.ts       # screenshot / mouse / keyboard (native APIs)
      mcp.ts                # MCP client (scan + stdio + reconnect)
      mcp-server.ts         # MCP server (HTTP+SSE, run_agent, token auth)
      skills.ts             # skills/commands/agents/plugin scanning
      plugins.ts            # plugin loader (SDK v3: tools/slash commands/hooks/panels)
      store.ts              # better-sqlite3 + FTS5
      settings.ts           # config (encrypted API key, lang, embedding)
    preload/preload.ts      # narrow contextBridge API
    renderer/
      index.html quick.html styles.css
      app.ts                # dashboard logic (chat, sidebar, tabs, context inspector)
      quick.ts              # quick panel logic
      dashboard.ts          # cost/token dashboard window
      arena.ts              # deep-analysis dashboard
      memory-graph.ts       # memory graph SVG visualization
      town.ts               # Town view (remote-node visualization)
      files-pane.ts         # file browsing + webview preview + editor
      code-editor.ts        # code editor (syntax highlighting)
      file-drawer.ts        # file drawer UI
      nexus.ts              # Nexus view
      focus-manager.ts      # focus / focus-trap management
      highlight.ts          # chat code-block syntax highlighting
      markdown.ts           # mini markdown renderer
  plugins/                  # 20 built-in plugins (SDK v3)

Compilar / desarrollar

npm run build       # tsc (main/preload/shared) + esbuild (renderer) + copy brand.json
npm run typecheck   # typecheck both halves, no emit
npm start           # launch (requires a prior build)
npm run dev         # build + start

Empaquetado

npm run dist         # default target for the current platform

• Windows: release\KinetAios Setup <ver>.exe (NSIS). Debe compilarse en Windows (la compilación cruzada de Windows + módulos nativos desde macOS no es fiable).
• macOS: compilar un dmg con npx electron-builder --mac (requiere un toolchain de Mac).
• electron-builder recompila better-sqlite3 contra el ABI de Electron automáticamente; asar: false evita errores de carga de módulos nativos en asar.
• Compilaciones sin firmar → Windows SmartScreen / macOS Gatekeeper advertirán; permitir manualmente. Eliminar la advertencia requiere un certificado de firma (+ notarización de Apple).
• El icono por defecto es el de Electron; reemplázalo con el tuyo: build/icon.ico (256×256) en Windows, build/icon.icns en macOS.

Limitaciones conocidas

• El comportamiento al cerrar la ventana es configurable (salir / minimizar / bandeja), por defecto minimizar. El atajo global solo funciona mientras la aplicación está en ejecución.
• Sin compilación cruzada — compila instaladores de Windows en una máquina Windows o en un runner de GitHub Actions windows-latest, y dmgs en un Mac (la recompilación de módulos nativos necesita el toolchain de destino).
• Las rutas de código específicas de plataforma (shell / PATH / atajo / bandeja) deben verificarse en su sistema operativo de destino.

---

La familia Kinet

KinetAios es parte de la familia Kinet:

• KinetFit — compañero de salud inteligente
• KinetAgent — asistente de automatización con IA
• KinetBrief — aplicación de resúmenes / notas con IA
• KinetTask — gestor de tareas local-first con IA en el dispositivo (Mac App Store)

Licencia

GPL-3.0