Hyperconsciousness

Servidor MCP en fase alfa de desarrollo, mantenido por Louis Beaumont, con búsqueda y recuperación sobre conocimiento cifrado y de solo añadidura mediante permisos con alcance y caducidad.

GitHub
5
Prueba este MCPPatrocinado

Documentación

Hyperconsciousness (hc)

HC es un almacén de conocimiento cifrado y de solo añadidura para humanos y agentes. Mantiene registros firmados sincronizados entre dispositivos. Tú decides qué puede acceder un agente y durante cuánto tiempo mediante concesiones con alcance y caducidad.

El repositorio contiene el motor Rust, la CLI, el servidor MCP/HTTP y las habilidades del agente, junto con el panel local opcional descrito a continuación. Las aplicaciones de escritorio, iOS, Android y web móvil están fuera de su alcance. Private Companion y la orquestación de agentes se mantienen por separado.

HC es una alfa para desarrolladores, por lo que las API y los comandos pueden cambiar. No se afirma una auditoría de seguridad independiente. Lee los límites de seguridad antes de usarlo para datos importantes. El paquete es hyperconsciousness; ejecútalo con hc.

Instalación

En macOS o Linux, instala la última alfa publicada con un comando:

curl -fsSL https://raw.githubusercontent.com/louis030195/hyperconsciousness/main/install.sh | sh

El instalador verifica la suma de verificación y la versión antes de instalar en ~/.local/bin. No crea un cerebro ni inicia un servicio. Sigue su instrucción de PATH si es necesario. Lanzamientos de GitHub incluyen compilaciones para Apple Silicon/Intel Mac, Linux x86-64/ARM64 y Windows x86-64. Las compilaciones de Linux requieren bibliotecas compatibles con Ubuntu 24.04; las compilaciones de Mac no están notarizadas. En Windows, extrae el ZIP y ejecuta hc.exe.

Las copias gestionadas por el instalador se actualizan automáticamente desde los lanzamientos de GitHub. Al usarlo, HC verifica en segundo plano como máximo una vez cada seis horas. Los comandos en ejecución y las sesiones MCP mantienen su binario actual; el siguiente lanzamiento usa la actualización. No se inicia ningún panel ni servicio de actualización persistente. Los usuarios de Windows ZIP pueden optar por participar con hc update --enable.

Usa hc update para actualizar ahora, hc update --check para verificar sin instalar, o hc update --disable para desactivarlo. HC_AUTO_UPDATE=0 omite las verificaciones automáticas para ese proceso. Las compilaciones de fuente/Cargo/npm y las instalaciones fijadas con HC_VERSION no optan automáticamente. Consulta comportamiento de actualización.

Para conectarte a una organización existente, usa su paquete de conexión:

hc setup company-hc.json --codex
hc login
hc status --remote

La configuración instala las habilidades de instrucción suministradas y registra HC con Codex. Inicia una nueva tarea de Codex después de iniciar sesión. No se necesitan Bun ni claves de API de proveedor. Consulta acceso alojado para otros clientes y límites de acceso. La conexión de la empresa es independiente de tu cerebro personal.

Ingestar chats y herramientas

El catálogo de habilidades de ingestión incluye chats de Codex y Claude, Slack, Google Workspace, GitHub, CRM, soporte, documentos, reuniones, análisis, anuncios, facturación, marketing y operaciones en la nube. Instala todas las recetas desde un clon:

python3 scripts/install-ingestion-skills.py --dest ~/.codex/skills

Para Claude Code, usa --dest ~/.claude/skills. Son instrucciones de agente portables que usan el acceso a la fuente existente y un escritor HC autorizado. Preservan la identidad de la fuente, la frescura y los recibos de reintento. Instalar habilidades no conecta cuentas ni inicia la ingestión en segundo plano; el catálogo explica la selección, los requisitos previos y la verificación.

Panel local

Usa el panel HC Atlas opcional para inspeccionar el almacenamiento, los metadatos de archivos, la identidad, las concesiones y los pares configurados. Puedes navegar con el teclado o usar su menú de comandos. La guía de interfaz y capturas de pantalla muestra cada vista. Con un lector HC autenticado existente configurado, Records también te permite buscar notas y registros de fuente importados, paginar resultados más antiguos y abrir vistas previas de texto.

El panel se ejecuta localmente y requiere una instalación HC existente. Instálalo por separado de la CLI. Los agentes pueden iniciarlo cuando una inspección visual sería útil; las notas de inicio del agente explican cómo.

Consulta los requisitos previos y luego ejecuta estos comandos desde la raíz del repositorio:

cd dashboard
bun install --frozen-lockfile
bun run build
bun run start

Abre http://127.0.0.1:3217, o reutiliza el panel allí si ya está en ejecución. Su servidor sigue ejecutándose cuando cierras el navegador y se detiene cuando finalizas el proceso del servidor. El inicio es manual: la configuración de HC y los comandos CLI no lanzan el panel ni abren un navegador. El panel inspecciona metadatos locales; no proporciona acceso de equipo alojado.

Instalar desde la fuente

Instala Rust con rustup. Este checkout fija Rust 1.88.0. Las compilaciones de Linux también necesitan encabezados nativos; en Ubuntu o Debian, instálalos con:

sudo apt-get install build-essential pkg-config libssl-dev libdbus-1-dev

Compila la fuente en macOS o Linux:

git clone https://github.com/louis030195/hyperconsciousness.git
cd hyperconsciousness
cargo build --release --locked
mkdir -p "$HOME/.local/bin"
install -m 755 target/release/hc "$HOME/.local/bin/hc"
export PATH="$HOME/.local/bin:$PATH"
hc --help

En Windows, usa cargo build --release --locked y ejecuta target\release\hc.exe. Agrega el directorio del binario a tu PATH si es necesario.

El paquete del registro npm no es la fuente de distribución para esta alfa. Usa los binarios verificados anteriores o compila este checkout. El empaquetado npm sigue probado para compatibilidad. Consulta automatización de lanzamientos.

Probar un almacén aislado

Prueba HC en un directorio nuevo. Pasar ese directorio a cada comando mantiene este ejemplo separado de un almacén personal existente:

HC_STORE="$PWD/hc-demo"
hc start --dir "$HC_STORE"
hc write "A demo note" --tags demo --sensitivity normal --dir "$HC_STORE"
hc read --dir "$HC_STORE"
hc status --dir "$HC_STORE"

hc read muestra registros locales sin una verificación de integridad completa. Puede mostrar un registro cuya firma fue modificada y puede salir con éxito después de retener un registro cuyo texto cifrado fue modificado. Las lecturas MCP con alcance de concesión verifican el historial y rechazan esas mutaciones. Para validar copias de seguridad, usa el flujo documentado de verificación de recuperación y perforación.

Dar a un agente acceso limitado

Para un agente que se ejecuta en el mismo nodo de confianza, concede acceso a la identidad del dispositivo de ese nodo. Este ejemplo permite un día de acceso de solo lectura a notas normales etiquetadas demo:

HC_DEVICE="$(hc id --dir "$HC_STORE" | cut -d: -f2)"
hc grant "$HC_DEVICE" --kinds note --tags demo \
  --sensitivity normal --days 1 --dir "$HC_STORE"
hc grants --dir "$HC_STORE"

Copia el id de concesión en tu configuración de cliente MCP. Usa rutas absolutas para tu ejecutable HC y el almacén que elegiste:

{
  "mcpServers": {
    "hc": {
      "command": "/absolute/path/to/hc",
      "args": ["mcp", "--as", "<grant-id>", "--dir", "/absolute/path/to/hc-demo"]
    }
  }
}

La búsqueda MCP admite un modo de relevancia léxica opcional para consultas de varias palabras. La búsqueda literal y la paginación cronológica siguen siendo el valor predeterminado. El modo de relevancia no requiere modelo ni servicio externo.

MCP expone overview, request_access, access_status, search, recent, record, remember, remember_many, use_secret y files. La presencia de una herramienta no otorga permiso para usarla. Agrega --write solo cuando el agente necesite acceso de captura. Las operaciones de credenciales requieren una concesión USE separada y una solicitud de dispositivo firmada. Para miembros de la empresa, grupos, múltiples dispositivos y agentes, usa acceso de puerta de enlace de empresa. El modo de empresa verifica la membresía actual en cada llamada de herramienta y requiere firma de solicitud del lado del cliente.

hc revoke <grant-id> --dir "$HC_STORE"
hc audit --dir "$HC_STORE"

Las concesiones limitan lo que devuelve el servidor. Un proceso con acceso a la cuenta, archivos o claves del sistema operativo del propietario aún tiene ese acceso; las concesiones no lo aíslan. Los proveedores de modelos alojados pueden ver el texto plano devuelto a través de sus concesiones.

El servidor HTTP admite API de OAuth/DPoP, captura y aprobación del propietario para clientes separados. No tiene aplicación incluida ni interfaz de aprobación. Los nombres de API /mobile/... existentes se conservan para compatibilidad; las páginas y activos de cliente eliminados devuelven 404.

Mantener datos de empresa y personales separados

Inicializa almacenes de empresa y personales de forma independiente. Dale a cada uno su propia identidad de tiempo de ejecución y credenciales, y selecciona el almacén con una ruta --dir explícita. Los nombres de directorio por sí solos no proporcionan aislamiento del sistema operativo. Ejecuta agentes de empresa no confiables bajo una cuenta de sistema operativo separada o en un host separado.

No pongas claves de API, frases de recuperación ni datos privados del cerebro en Git, habilidades, capas de contenedor o imágenes de máquina. Los adaptadores de credenciales retienen valores secretos; HC almacena referencias de capacidad opacas y concede operaciones específicas.

Documentación

Desarrollo

cargo fmt --all -- --check
cargo clippy --locked --all-targets -- -D warnings
cargo test --locked
npm test
npm pack --dry-run
cargo package --locked

Licencia MIT. Consulta LICENCIA.