Neotoma

Opciones de instalación

Integración en 5 minutosCompletamente reversible

¿Quieres la secuencia completa guiada por el agente? Empieza con la evaluación, deja que el agente instale si hace falta, activa Neotoma con tus datos y configura la herramienta en la que estás.

Comenzar con evaluación →

Instalación asistida por agente

Si quieres saltarte la evaluación inicial y seguir directamente desde la instalación, pega este prompt en Claude, Codex, Cursor o un agente similar. El prompt es breve a propósito; esta página documenta la secuencia completa de instalación primero que debe seguir.

Agent prompt
Paste this into an assistant to run the install-first Neotoma flow.
Read https://neotoma.io/install and carry me through the install-first Neotoma flow.

Use `neotoma` commands for status and setup. If Neotoma is already installed, start with `neotoma doctor --json`; otherwise install it and run `neotoma setup --tool <my_tool> --yes`.

Avoid ad-hoc shell introspection or arbitrary repo scripts. Then activate Neotoma with my data and configure my current tool for robust ongoing use.

Esta página amplía el prompt. El prompt copiado omite detalle por legibilidad; el flujo completo de instalación primero aquí incluye:

  1. Confirmar que el usuario quiere la vía de instalación primero e identificar la herramienta actual.
  2. Instalar solo si hace falta y verificar el estado con neotoma doctor --json.
  3. Elegir los primeros datos a almacenar y el modo de incorporación.
  4. Ejecutar la activación y configurar la herramienta actual para uso continuo.

Secuencia de instalación expandida

Usa esta vía solo cuando el usuario ya quiera seguir con Neotoma y no necesite el flujo más amplio de encaje en /evaluate.

  1. Confirmar la vía de instalación primero - verificar que el usuario quiere continuar ya, identificar su herramienta actual y anotar restricciones importantes que afecten la calidad de la configuración.
  2. Install only if needed - check whether Neotoma is already installed. If not, branch by tool: for OpenClaw, prefer openclaw plugins install clawhub:neotoma; for other local tools, run npm install -g neotoma. Then collapse the rest of setup into two calls: neotoma doctor --json to inspect consolidated state and neotoma setup --tool <tool> --yes to apply init + MCP + CLI instructions + permission files idempotently. If Neotoma is already installed, just run neotoma doctor --json to verify.
  3. No improvises introspección en shell. Do not run python3 -c, grep -r, ls, cat, jq, find, which, or node -e to introspect Neotoma, and do not run arbitrary npm run scripts from the user's repositories. If a permission prompt appears for anything other than neotoma * or npm install -g neotoma, stop and ask the user to widen the allowlist (see the Permissions pre-flight block above) rather than substituting another command.
  4. Definir el primer objetivo de datos - determinar qué datos guardar primero y, si hace falta, preguntar el modo de incorporación: victoria rápida, guiado o usuario avanzado.
  5. Ejecutar la activación - ejecuta la secuencia de activación enlazada abajo: descubrir candidatos, previsualizarlos, ingerir fuentes confirmadas, reconstruir una línea de tiempo y luego consultar y corregir.
  6. Configurar la herramienta actual - cuando ya haya valor visible, configura el flujo Neotoma más sólido para la herramienta en uso. En OpenClaw mantén la ruta nativa de plugin por defecto y el cableado MCP manual solo como respaldo. Si la herramienta es demasiado limitada, dilo y recomienda un entorno principal mejor soportado.

Si tu agente exige listas de comandos permitidos, usa los fragmentos de pre-vuelo antes de ejecutar el prompt.

Permissions pre-flight (copy once, before running the agent prompt below)

Paste this snippet into the right file for your agent harness so the rest of onboarding only needs two approvals: neotoma * and one npm install -g neotoma. Without this, directory-scoped harnesses will prompt for every individual command.

Using OpenClaw? Skip this — the native plugin handles consent. Just run openclaw plugins install clawhub:neotoma and approve the plugin permission prompt once.

JSON merge into Claude Code's permissions file.

Target: .claude/settings.local.json (project) — or ~/.claude/settings.json (user)

// Paste into .claude/settings.local.json (project) or ~/.claude/settings.json (user).
// Merge with any existing "permissions.allow" list.
{
  "permissions": {
    "allow": [
      "Bash(neotoma:*)",
      "Bash(npm install -g neotoma:*)"
    ]
  }
}

Referencia escrita canónica: install.md. Si el usuario quiere primero el flujo más amplio de cualificación, envíalo a /evaluate.

Más opciones: Instalación manual · Docker · Referencia CLI

Qué cambia en tu sistema

npm install -g neotoma añade un binario CLI. neotoma init crea un directorio de configuración, una base SQLite local y un archivo env. Los avisos opcionales durante init pueden añadir entradas MCP y archivos de instrucciones CLI; eliges en cada paso. Nada se ejecuta en segundo plano salvo que lo arranques. Sin telemetría ni llamadas a casa.

CreadoRutaÁmbitoneotoma reset
Paquete npm globalneotoma (node_modules global)Globalnpm uninstall -g neotoma
Directorio de configuración~/.config/neotoma/UsuarioCopia de seguridad y eliminación
Archivo de entorno~/.config/neotoma/.env o <proyecto>/.envUsuario / ProyectoCopia de seguridad y eliminación
Bases SQLite<data-dir>/neotoma.db, neotoma.prod.dbLocalCopia de seguridad y eliminación
Directorios de datos<data-dir>/sources/, <data-dir>/logs/LocalCopia de seguridad y eliminación
Entradas de config MCP (opcional).cursor/mcp.json, claude.json, etc.Usuario / ProyectoEntradas eliminadas de las configs
Reglas de instrucciones CLI (opcional).cursor/rules/, .claude/rules/Usuario / ProyectoCopia de seguridad y eliminación

neotoma reset hace copia de seguridad de cada elemento en un directorio con marca temporal antes de eliminarlo y luego ejecuta npm uninstall -g neotoma. Si tu .env define NEOTOMA_DATA_DIR, ese directorio queda protegido y no se elimina.

Documentación de integración directa

¿Conectas un agente a un Neotoma alojado en lugar de instalar en local? Las instancias alojadas exponen fragmentos de conexión por harness en su propia URL raíz (con el host rellenado): consulta Conectar remotamente o prueba el sandbox público.

Instalación manual y Docker

Instalación manual

npm install, verificación post-instalación, arranque del servidor API y conexión MCP.

Instalación Docker

Ejecuta Neotoma en Docker con docker-compose o contenedores independientes.

Referencia CLI →README completo →