Skip to main content

​
Quick install

The fastest way to install hcom is with the install script: 
curl -fsSL https://raw.githubusercontent.com/aannoo/hcom/main/install.sh | sh
This downloads the latest pre-built binary for your platform and installs it to ~/.local/bin/hcom.

​
Installation methods

​
Custom install directory

To install to a custom directory, set the HCOM_INSTALL_DIR environment variable: 
HCOM_INSTALL_DIR=/usr/local/bin curl -fsSL https://raw.githubusercontent.com/aannoo/hcom/main/install.sh | sh

​
Verify installation

Check that hcom is installed correctly: 
hcom --version
You should see: 
hcom (hook-comms) v0.7.1 - multi-agent communication
Run diagnostics: 
hcom status
This shows:
  • Installation status
  • Hook status for Claude Code, Gemini CLI, Codex, and OpenCode
  • Database location
  • Configuration file location

​
What gets installed

Hooks go into ~/ (or HCOM_DIR) on launch or hcom start. If you aren’t using hcom, the hooks do nothing. 
hcom hooks remove  # safely remove only hcom hooks

​
Platform-specific notes

On macOS, the installer adds ~/.local/bin to your PATH in ~/.zshrc (default shell on macOS 10.15+) or ~/.bashrc.If you use a different shell, manually add:
export PATH="$HOME/.local/bin:$PATH"
Restart your terminal or run:
source ~/.zshrc  # or ~/.bashrc
On Linux, the installer adds ~/.local/bin to your PATH in ~/.bashrc or ~/.zshrc.If the binary isn’t found after installation:
export PATH="$HOME/.local/bin:$PATH"
source ~/.bashrc  # or ~/.zshrc
On some distributions, you may need to install dependencies:
# Debian/Ubuntu
sudo apt install libsqlite3-dev

# Fedora/RHEL
sudo dnf install sqlite-devel
On Android with Termux, the install script automatically detects the platform and installs the Android-specific binary.
# In Termux
curl -fsSL https://raw.githubusercontent.com/aannoo/hcom/main/install.sh | sh
The Android binary uses Bionic libc instead of glibc and has a different dynamic linker path.

​
Updating hcom

To update to the latest version, simply re-run the install script: 
curl -fsSL https://raw.githubusercontent.com/aannoo/hcom/main/install.sh | sh
Or with pip: 
pip install --upgrade hcom
Or with uv: 
uv tool upgrade hcom

​
Uninstalling

To completely remove hcom:
1

Remove hooks

hcom hooks remove
2

Remove binary

rm ~/.local/bin/hcom
3

Remove data (optional)

rm -rf ~/.hcom
This deletes all hcom data including the database, config, and logs. Archive your data first if you need it.
4

Remove PATH entry (optional)

Remove the PATH export line from your shell config file (~/.bashrc, ~/.zshrc, etc.).

​
Next steps

Quickstart

Launch your first agents and send messages

Build docs developers (and LLMs) love

Get started for freeTalk to us