Skip to content

ph kb ​

Knowledge base on Tara: spaces, create, push (push local documents), search, rm

This page is generated from ph kb --help by npm run gen in site/, so do not edit it by hand.

text
Usage: ph kb <command>

spaces ​

text
spaces [--json]                          Knowledge spaces I can read (writable: marked *)

create ​

text
create <code> --name <name> [--project <key>] [--description <text>] [--json]
                                         Create a space in the current organization (owner, admin or member)

push ​

text
push <space> <path…> [--repo <repo>] [--commit <sha>] [--json]
                                         Read local files/folders (.md, .markdown, .mdx, .txt) and push them to Tara. Documents
                                         are keyed by their path from the git repo root: pushing again replaces the version,
                                         and identical content is skipped. --repo and --commit default to git (origin, HEAD) for citations
text
search <question…> [--space <code>] [--top-k <n>] [--json]
                                         Search the spaces I can read, with source citations

rm ​

text
rm <space> <source path…> [--json]      Delete documents by source path (the path `push` stored)

GitHub repositories as sources (owners and admins, signed in with ph login; the organization needs the GitHub App, see ph org github) ​

sources ​

text
sources [--json]                         Attached repositories with sync status

source add ​

text
source add <owner/repo | GitLab project URL> [--include <glob>]… [--json]
                                         Attach a repository of the GitHub App installation. Reads README, docs/ and ADRs (Markdown and
                                         text only) unless --include narrows it (repeatable, for example --include 'docs/**'). Keeps
                                         up to date on every push to the default branch. Each person sees documents of a private
                                         repository only if their own GitHub account can read it

source sync ​

text
source sync <owner/repo> [--wait] [--json]
                                         Sync now (--wait: until it finishes)

source remove ​

text
source remove <owner/repo> [--json]      Detach the repository and delete its documents
text
Tara address: PHILLIP_TARA_URL or ph tara login --url. Claude Code reads the same source through the kit-knowledge kit (MCP).