kb-setup

To initialize a local knowledge base config, the setup process writes ~/.kb/config.json and creates a kb/ subdirectory under the first allow_list path. This resolves missing configuration errors and establishes the base directory structure required for knowledge base operations.

The best way to update allow_list and disallow_list is to apply a dedicated configuration skill that writes the updated path arrays directly into ~/.kb/config.json. This ensures the search indexes the correct directories while excluding restricted paths from the results.

Knowledge base search fails when ~/.kb/config.json is missing because the search mechanism requires this file to locate valid directories via the allow_list. Without this config file, the system has no paths to index, resulting in execution failure.

Yes, you need jq installed to configure knowledge base paths because the initialization script relies on this dependency to parse and write the JSON configuration structure into ~/.kb/config.json. The setup process requires this command-line JSON processor to be available in the environment.

To reset knowledge base configuration, execute the initialization script to overwrite the existing ~/.kb/config.json. This action rewrites the JSON config with fresh allow_list and disallow_list parameters and recreates the kb/ subdirectory under the primary allow_list path if needed.