louis030195/hyperconsciousness

HC is an encrypted, append-only knowledge store for humans and agents. One
trusted node owns the store; other devices use its authenticated API. You
choose what an agent can access and for how long through scoped, expiring
grants. The node can run on your own machine or server.
The repository contains the Rust engine, CLI, MCP/HTTP server, and agent skills,
along with the optional local dashboard described below. Desktop, iOS, Android,
and mobile web apps are outside its scope. Private Companion and agent
orchestration are maintained separately.
HC is a developer alpha, so APIs and commands may change. No independent
security audit is claimed. Read the security limits before
using it for important data. The package is hyperconsciousness; run it with hc.
Read HC for humans for permissions, sharing, privacy and working with agents.
Agents can follow the usage skill.
## Install
On macOS or Linux, install the latest published alpha with one command:
sh
curl -fsSL https://raw.githubusercontent.com/louis030195/hyperconsciousness/main/install.sh | sh
The installer verifies the release checksum and version before installing to
~/.local/bin. It does not create a brain or start a service. Follow its PATH
instruction if needed. GitHub releases
include Apple Silicon/Intel Mac, Linux x86-64/ARM64 and Windows x86-64 builds.
Linux builds require Ubuntu 24.04-compatible libraries; Mac builds are not
notarized. On Windows, extract the ZIP and run hc.exe.
Installer-managed copies update automatically from GitHub releases. On use, HC
checks in the background at most once every six hours. Running commands and MCP
sessions keep their current binary; the next launch uses the update. No dashboard
or persistent updater service starts. Windows ZIP users can opt in with
hc update --enable.
Use hc update to update now, hc update --check to check without installing,
or hc update --disable to turn it off. HCAUTOUPDATE=0 skips automatic checks
for that process. Source/Cargo/npm builds and installs pinned with HCVERSION
do not opt in automatically. See update behavior.
To connect to an existing organization, use its connection pack:
sh
hc setup company-hc.json --codex
hc login
hc status --remote
Setup installs the supplied instruction skills and registers HC with Codex.
Start a new Codex task after signing in. No Bun or provider API keys are needed.
See hosted access for other clients and access boundaries.
The company connection is separate from your personal brain.
## Ingest chats and tools
The ingestion skill catalog includes Codex and Claude chats,
Slack, Google Workspace, GitHub, CRM, support, documents, meetings, analytics,
ads, billing, marketing and cloud operations. Install all recipes from a clone:
sh
python3 scripts/install-ingestion-skills.py --dest ~/.codex/skills
For Claude Code, use --dest ~/.claude/skills. These are portable agent
instructions using existing source access and an authorized HC writer. They
preserve source identity, freshness and retry receipts. Installing skills does
not connect accounts or start background ingestion; the catalog explains
selection, prerequisites and verification.
## Local dashboard
Use the optional HC Atlas dashboard to inspect storage,