Saltar al contenido principal

Descripción General

Los comandos de la Base de Conocimiento (KB) te permiten gestionar la documentación tipo wiki de tu proyecto directamente desde el terminal. Todos los comandos de KB se limitan a un proyecto mediante la flag -p/--project.
La Base de Conocimiento es un recurso a nivel de proyecto. Cada página pertenece a exactamente un proyecto. Usa Notas Personales para contenido privado con alcance de usuario.

Comandos

Listar Páginas

# All pages in a project
apollo kb list -p "Apollo"

# Filter by folder
apollo kb list -p "Apollo" --folder "Architecture"

# Limit results
apollo kb list -p "Apollo" --limit 20
Opciones:
FlagDescripción
-p, --project <name>Nombre o ID del proyecto (obligatorio)
--folder <name>Filtrar por nombre de carpeta
--limit <n>Máximo de resultados (por defecto: 50)

Ver una Página

# By title (fuzzy match)
apollo kb view "deployment guide"

# By UUID
apollo kb view 550e8400-e29b-41d4-a716-446655440000
Muestra el contenido completo de la página, carpeta, número de versión y metadatos.

Buscar Páginas

Busca páginas de la KB por título o contenido dentro de un proyecto:
apollo kb search "authentication" -p "Apollo"
apollo kb search "API design" -p "Apollo" --limit 10
Usa coincidencia de subcadena sin distinguir mayusculas ni minusculas en los campos de título y contenido.

Crear una Página

# With inline content
apollo kb create -t "Deployment Guide" -p "Apollo" --content "## Steps\n1. Build\n2. Deploy"

# From a file
apollo kb create -t "API Reference" -p "Apollo" --file ./api-docs.md

# In a specific folder
apollo kb create -t "Auth Flow" -p "Apollo" --content "..." --folder "Architecture"
Opciones:
FlagDescripción
-t, --title <title>Título de la página (obligatorio)
-p, --project <name>Nombre o ID del proyecto (obligatorio)
--content <text>Contenido de la página (markdown)
--file <path>Leer contenido de un archivo
--folder <name>Colocar en una carpeta específica

Actualizar una Página

# Update content
apollo kb update "Deployment Guide" --content "Updated deployment steps..."

# Update from file
apollo kb update "API Reference" --file ./api-docs-v2.md

# Move to a different folder
apollo kb update "Auth Flow" --folder "Security"

# Rename
apollo kb update "Deployment Guide" -t "Production Deployment Guide"

Eliminar una Página

Eliminación temporal de una página (se puede restaurar después):
apollo kb delete "Old Draft"

Listar Carpetas

apollo kb folders -p "Apollo"
Muestra todas las carpetas de la KB del proyecto con relaciones padre-hijo.

Salida JSON

# List as JSON
apollo kb list -p "Apollo" --json

# Search as JSON
apollo kb search "auth" -p "Apollo" --json

# View as JSON (full content)
apollo kb view "Deployment Guide" --json

Ejemplos con Piping

# Get all page titles
apollo kb list -p "Apollo" --json | jq '.[].title'

# Export a page to a file
apollo kb view "API Reference" --json | jq -r '.content' > api-reference.md