Hyperconsciousness

Servidor MCP developer-alpha mantido por Louis Beaumont, com busca e recuperação sobre conhecimento criptografado e somente de acréscimo, por meio de concessões com escopo e expiração.

GitHub
5
Experimente este MCPPatrocinado

Documentação

Hyperconsciousness (hc)

HC é um armazenamento de conhecimento criptografado, somente de acréscimo, para humanos e agentes. Ele mantém registros assinados sincronizados entre dispositivos. Você escolhe o que um agente pode acessar e por quanto tempo, por meio de concessões com escopo e expiração.

O repositório contém o mecanismo Rust, CLI, servidor MCP/HTTP e habilidades de agente, juntamente com o painel local opcional descrito abaixo. Aplicativos para desktop, iOS, Android e web móvel estão fora do seu escopo. O Private Companion e a orquestração de agentes são mantidos separadamente.

HC é um alfa para desenvolvedores, portanto, APIs e comandos podem mudar. Nenhuma auditoria de segurança independente é reivindicada. Leia os limites de segurança antes de usá-lo para dados importantes. O pacote é hyperconsciousness; execute-o com hc.

Instalação

No macOS ou Linux, instale o alfa publicado mais recente com um comando:

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

O instalador verifica a soma de verificação e a versão do lançamento antes de instalar em ~/.local/bin. Ele não cria um cérebro nem inicia um serviço. Siga a instrução de PATH, se necessário. Lançamentos do GitHub incluem builds para Apple Silicon/Intel Mac, Linux x86-64/ARM64 e Windows x86-64. Os builds Linux exigem bibliotecas compatíveis com Ubuntu 24.04; os builds Mac não são notarizados. No Windows, extraia o ZIP e execute hc.exe.

Cópias gerenciadas pelo instalador são atualizadas automaticamente a partir dos lançamentos do GitHub. Ao usar, o HC verifica em segundo plano no máximo uma vez a cada seis horas. Comandos em execução e sessões MCP mantêm o binário atual; o próximo lançamento usa a atualização. Nenhum painel ou serviço de atualização persistente é iniciado. Usuários do ZIP no Windows podem optar por participar com hc update --enable.

Use hc update para atualizar agora, hc update --check para verificar sem instalar, ou hc update --disable para desativar. HC_AUTO_UPDATE=0 ignora verificações automáticas para esse processo. Builds de fonte/Cargo/npm e instalações fixadas com HC_VERSION não optam por participar automaticamente. Consulte comportamento de atualização.

Para se conectar a uma organização existente, use o pacote de conexão dela:

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

A configuração instala as habilidades de instrução fornecidas e registra o HC com o Codex. Inicie uma nova tarefa do Codex após entrar. Não são necessários Bun ou chaves de API do provedor. Consulte acesso hospedado para outros clientes e limites de acesso. A conexão da empresa é separada do seu cérebro pessoal.

Ingerir conversas e ferramentas

O catálogo de habilidades de ingestão inclui conversas do Codex e Claude, Slack, Google Workspace, GitHub, CRM, suporte, documentos, reuniões, análises, anúncios, cobrança, marketing e operações em nuvem. Instale todas as receitas a partir de um clone:

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

Para Claude Code, use --dest ~/.claude/skills. Estas são instruções de agente portáteis que usam acesso de fonte existente e um gravador HC autorizado. Elas preservam a identidade da fonte, a atualização e os recibos de repetição. Instalar habilidades não conecta contas nem inicia ingestão em segundo plano; o catálogo explica seleção, pré-requisitos e verificação.

Painel local

Use o painel HC Atlas opcional para inspecionar armazenamento, metadados de arquivos, identidade, concessões e pares configurados. Você pode navegar com o teclado ou usar o menu de comandos. O guia de interface e capturas de tela mostra cada visualização. Com um leitor HC autenticado existente configurado, Records também permite pesquisar notas e registros de fonte importados, percorrer resultados mais antigos e abrir pré-visualizações de texto.

O painel é executado localmente e requer uma instalação HC existente. Instale-o separadamente da CLI. Agentes podem iniciá-lo quando uma inspeção visual ajudar; as notas de inicialização do agente explicam como.

Verifique os pré-requisitos e execute estes comandos a partir da raiz do repositório:

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

Abra http://127.0.0.1:3217, ou reutilize o painel lá se já estiver em execução. O servidor dele continua em execução quando você fecha o navegador e para quando você encerra o processo do servidor. A inicialização é manual: a configuração do HC e os comandos da CLI não iniciam o painel nem abrem um navegador. O painel inspeciona metadados locais; ele não fornece acesso de equipe hospedado.

Instalar a partir da fonte

Instale Rust com rustup. Este checkout fixa Rust 1.88.0. Builds Linux também precisam de cabeçalhos nativos; no Ubuntu ou Debian, instale-os com:

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

Compile a fonte no macOS ou 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

No Windows, use cargo build --release --locked e execute target\release\hc.exe. Adicione o diretório do binário ao seu PATH, se necessário.

O pacote do registro npm não é a fonte de distribuição para este alfa. Use os binários verificados acima ou compile este checkout. O empacotamento npm permanece testado para compatibilidade. Consulte automação de lançamento.

Experimente um armazenamento isolado

Experimente o HC em um novo diretório. Passar esse diretório para cada comando mantém este exemplo separado de um armazenamento pessoal 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 exibe registros locais sem uma verificação completa de integridade. Ele pode exibir um registro cuja assinatura foi modificada e pode sair com sucesso após reter um registro cujo texto cifrado foi modificado. Leituras MCP com escopo de concessão verificam o histórico e rejeitam essas mutações. Para validar backups, use o fluxo de verificação de recuperação e perfuração documentado.

Dar a um agente acesso limitado

Para um agente em execução no mesmo nó confiável, conceda acesso à identidade do dispositivo desse nó. Este exemplo permite um dia de acesso somente leitura a notas normais marcadas com 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"

Copie o ID da concessão para a configuração do seu cliente MCP. Use caminhos absolutos para o seu executável HC e o armazenamento escolhido:

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

A pesquisa MCP suporta um modo de relevância lexical opcional para consultas com várias palavras. A pesquisa literal e a paginação cronológica permanecem o padrão. O modo de relevância não requer modelo ou serviço externo.

O MCP expõe overview, request_access, access_status, search, recent, record, remember, remember_many, use_secret e files. A presença de uma ferramenta não concede permissão para usá-la. Adicione --write somente quando o agente precisar de acesso de captura. Operações de credenciais exigem uma concessão USE separada e uma solicitação de dispositivo assinada. Para membros da empresa, grupos, vários dispositivos e agentes, use acesso de gateway da empresa. O modo empresa verifica a associação atual em cada chamada de ferramenta e exige assinatura de solicitação no lado do cliente.

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

As concessões limitam o que o servidor retorna. Um processo com acesso à conta, arquivos ou chaves do sistema operacional do proprietário ainda tem esse acesso; as concessões não o isolam em sandbox. Provedores de modelo hospedados podem ver o texto simples retornado por meio de suas concessões.

O servidor HTTP suporta APIs OAuth/DPoP, captura e aprovação do proprietário para clientes separados. Ele não tem aplicativo ou interface de aprovação integrados. Os nomes de API /mobile/... existentes são preservados para compatibilidade; páginas e ativos de cliente removidos retornam 404.

Manter dados da empresa e pessoais separados

Inicialize armazenamentos da empresa e pessoais de forma independente. Dê a cada um sua própria identidade de tempo de execução e credenciais, e selecione o armazenamento com um caminho --dir explícito. Nomes de diretórios sozinhos não fornecem isolamento do sistema operacional. Execute agentes de empresa não confiáveis sob uma conta de sistema operacional separada ou em um host separado.

Não coloque chaves de API, frases de recuperação ou dados privados do cérebro em Git, habilidades, camadas de contêiner ou imagens de máquina. Adaptadores de credenciais retêm valores secretos; o HC armazena referências de capacidade opacas e concede operações específicas.

Documentação

Desenvolvimento

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

Licenciado sob MIT. Consulte LICENSE.