install.md

Installation Guide

This document provides detailed installation instructions for kibi.

Prerequisites

Kibi depends on SWI-Prolog 9.0+. You must have swipl installed and available in your PATH before installing kibi.

Installing SWI-Prolog on Linux

Ubuntu (Recommended)

The official SWI-Prolog project provides a Personal Package Archive (PPA) for Ubuntu that stays current with every release. This is the recommended installation method for Ubuntu users.

sudo apt-get install software-properties-common
sudo apt-add-repository ppa:swi-prolog/stable
sudo apt-get update
sudo apt-get install swi-prolog

Other Linux Distributions

Official Linux distribution packages are often outdated. For other Linux distributions, please refer to the official SWI-Prolog documentation:

• Unix/Linux installation guide - Comprehensive instructions for building from source or using other methods
• Stable downloads page - Source archives and binaries
• Flatpak - Available for most Linux distributions

Verify SWI-Prolog Installation

After installation, verify that swipl is available:

swipl --version

You should see output like SWI-Prolog version 10.x.x.

Installing kibi

Using npm (Primary)

Install the kibi CLI and MCP server globally using npm:

npm install -g kibi-cli kibi-mcp

Using bun (Alternative)

If you prefer bun as your package manager:

bun add -g kibi-cli kibi-mcp

Verify kibi Installation

After installation, verify that both tools are available:

kibi --version
kibi-mcp --help

Development / dogfood workflow for this repository

This repository uses local built kibi-mcp and kibi-opencode artifacts in its OpenCode setup. After changing package versions or local package wiring, rebuild before testing or using OpenCode here:

bun run build

Troubleshooting Installation

Command Not Found

If you see "command not found" after installing kibi, you may need to adjust your PATH:

1. Check global npm/bin location:

   npm config get prefix

   The output shows where npm installs global packages.

2. Add to PATH (if needed): Add the global bin directory to your shell configuration:

   # For bash (in ~/.bashrc or ~/.bash_profile):
   export PATH="$PATH:/usr/local/bin"
   # For zsh (in ~/.zshrc):
   export PATH="$PATH:/home/$USER/.npm-global/bin"

3. Reload your shell configuration:

   source ~/.bashrc  # or source ~/.zshrc

SWI-Prolog Issues

If you encounter problems with SWI-Prolog:

• Refer to the SWI-Prolog build documentation for platform-specific guidance
• Check the SWI-Prolog FAQ
• Report issues on the SWI-Prolog forum

Next Steps

After installing kibi and verifying SWI-Prolog:

1. Verify your environment: kibi doctor
2. Initialize your project: kibi init
3. Import documentation: kibi sync
4. Explore the KB: kibi search <query>
5. Inspect branch freshness: kibi status
6. Validate integrity: kibi check

Example:

kibi doctor
kibi init
kibi sync
kibi search auth
kibi status
kibi check

For more details, see:

• Quick Start - Brief getting started guide
• CLI Reference - Complete command documentation
• Troubleshooting - Recovery procedures