Client Tools

Tools for connecting to a Knowledge Graph platform.

Installation

All-in-one Installer

curl -fsSL https://raw.githubusercontent.com/aaronsb/knowledge-graph-system/main/client-manager.sh | bash

This interactive installer: - Detects your OS (Arch, Ubuntu, Fedora, macOS) - Installs prerequisites if needed (Node.js, pipx) - Installs the kg CLI from npm - Optionally installs the FUSE driver from PyPI - Configures authentication

Manual Installation

kg CLI only:

npm install -g @aaronsb/kg-cli
kg config set api_url https://kg.example.com/api
kg login

FUSE driver:

pipx install kg-fuse

Components

kg CLI

Command-line interface for the knowledge graph.

kg health              # Check connection
kg search "query"      # Search concepts
kg ingest file.pdf     # Ingest documents
kg --help              # All commands

See CLI Reference for full documentation.

MCP Server

Enables AI assistants (Claude, etc.) to use the knowledge graph.

kg mcp-config          # Configure for Claude Desktop
kg oauth create-mcp    # Create MCP OAuth client

See MCP Reference for tool documentation.

FUSE Filesystem

Mount the knowledge graph as a filesystem.

kg-fuse ~/Knowledge    # Mount at ~/Knowledge
ls ~/Knowledge/        # Browse ontologies
cat ~/Knowledge/query/your\ search  # Semantic queries

See FUSE Guide for details.

Upgrading

# Using the installer
./client-manager.sh --upgrade

# Manual
npm update -g @aaronsb/kg-cli
pipx upgrade kg-fuse

Uninstalling

# Using the installer
./client-manager.sh --uninstall

# Manual
npm uninstall -g @aaronsb/kg-cli
pipx uninstall kg-fuse

Troubleshooting

"Command not found" after installation

Ensure ~/.local/bin is in your PATH:

export PATH="$HOME/.local/bin:$PATH"

Add to your shell profile (~/.bashrc, ~/.zshrc) for persistence.

Authentication issues

kg logout              # Clear credentials
kg login               # Re-authenticate

Connection refused

Check the API URL:

kg config get api_url
curl -s https://kg.example.com/api/health