Core CLI Reference

Manage content, playbooks, skills, files, contexts, and artifacts with the core CLI domain. Your central hub for configuration and content management.

Last updated:

The core domain is your central hub for managing content, configuration, and operational resources. It handles playbooks, skills, files, content, contexts, and artifacts.

Why Core Exists

Every SystemPrompt project needs:

Playbooks - Step-by-step operational guides
Skills - Reusable agent capabilities
Files - Uploaded assets and documents
Content - Blog posts, documentation, pages
Contexts - Conversation and session state
Artifacts - Debug and inspection data

The core domain centralizes these essential resources.

Quick Reference

Subcommand	Description
`core playbooks`	Manage operational playbooks
`core skills`	Manage agent skills
`core files`	File uploads and management
`core content`	Content management
`core contexts`	Conversation contexts
`core artifacts`	Debug artifacts

Playbooks

Playbooks are step-by-step operational guides. They tell agents (and humans) exactly how to perform tasks.

List Playbooks

# List all playbooks
systemprompt core playbooks list

# Filter by category
systemprompt core playbooks list --category cli
systemprompt core playbooks list --category build
systemprompt core playbooks list --category content

Show Playbook

# Show playbook content (formatted)
systemprompt core playbooks show guide_start

# Raw markdown output (for piping)
systemprompt core playbooks show guide_start --raw

# JSON output
systemprompt --json core playbooks show guide_start

Sync Playbooks

Sync playbook files to/from the database:

# Sync from files to database
systemprompt core playbooks sync --direction to-db -y

# Sync from database to files
systemprompt core playbooks sync --direction to-disk -y

File locations:

services/playbook/
├── guide/      # guide_* playbooks
├── cli/        # cli_* playbooks
├── build/      # build_* playbooks
└── content/    # content_* playbooks

Skills

Skills are reusable agent capabilities defined in YAML files. They specify what an agent can do and how.

List Skills

# List all skills
systemprompt core skills list

# JSON output
systemprompt --json core skills list

Show Skill

# Show skill details
systemprompt core skills show writer

# JSON output
systemprompt --json core skills show writer

Edit Skill

# Open skill in editor
systemprompt core skills edit writer

Create Skill

# Create new skill
systemprompt core skills create --name "new-skill"

Sync Skills

# Sync from files to database
systemprompt core skills sync --direction to-db -y

# Sync from database to files
systemprompt core skills sync --direction to-disk -y

File locations:

services/skills/
├── writer.yaml
├── analyst.yaml
└── ...

Files

Manage file uploads and storage.

List Files

# List all files
systemprompt core files list

# List files in path
systemprompt core files list --path images/

# JSON output
systemprompt --json core files list

Upload File

# Upload file
systemprompt core files upload ./local-file.pdf

# Upload to specific path
systemprompt core files upload ./image.png --path images/blog/

# Upload with metadata
systemprompt core files upload ./doc.pdf --tags "report,2026"

Download File

# Download by ID
systemprompt core files download file_abc123

# Download to specific location
systemprompt core files download file_abc123 --output ./downloads/

Delete File

# Delete file (requires confirmation)
systemprompt core files delete file_abc123 --yes

File Statistics

# View storage statistics
systemprompt core files stats

Search Files

# Search by name
systemprompt core files search "report"

# Search with AI
systemprompt core files search "quarterly financial data" --ai

Validate Files

# Validate file integrity
systemprompt core files validate

Content

Manage blog posts, documentation, and other content.

List Content

# List all content
systemprompt core content list

# Filter by source
systemprompt core content list --source blog
systemprompt core content list --source documentation

# Limit results
systemprompt core content list --limit 10

Show Content

# Show content by ID
systemprompt core content show content_abc123

# Show by slug
systemprompt core content show --slug "blog/my-post"

Search Content

# Search content
systemprompt core content search "machine learning"

# Search in specific source
systemprompt core content search "agents" --source documentation

Create Content

# Create from file
systemprompt core content create --source blog --file ./post.md

# Create interactively
systemprompt core content create --source blog

Update Content

# Update content
systemprompt core content update content_abc123 --file ./updated-post.md

Delete Content

# Delete content
systemprompt core content delete content_abc123 --yes

Publish Content

# Publish all content from files to database
systemprompt core content publish

# Publish specific source
systemprompt core content publish --source blog

Contexts

Manage conversation and session contexts for agents.

List Contexts

# List all contexts
systemprompt core contexts list

# Filter by agent
systemprompt core contexts list --agent writer

Show Context

# Show context details
systemprompt core contexts show context_abc123

Delete Context

# Delete context
systemprompt core contexts delete context_abc123 --yes

# Delete all contexts for agent
systemprompt core contexts delete --agent writer --all --yes

Artifacts

Inspect debug artifacts from agent operations.

List Artifacts

# List recent artifacts
systemprompt core artifacts list

# Filter by type
systemprompt core artifacts list --type error
systemprompt core artifacts list --type response

Show Artifact

# Show artifact details
systemprompt core artifacts show artifact_abc123

Common Workflows

Setting Up a New Project

# Sync all playbooks
systemprompt core playbooks sync --direction to-db -y

# Sync skills
systemprompt core skills sync --direction to-db -y

# Publish content
systemprompt core content publish

Finding Information

# What playbook should I use?
systemprompt core playbooks list

# Read the getting started guide
systemprompt core playbooks show guide_start

# Search documentation
systemprompt core content search "deployment"

Managing Assets

# Upload images for blog
systemprompt core files upload ./hero.png --path images/blog/

# List uploaded files
systemprompt core files list --path images/

# Check storage usage
systemprompt core files stats

Playbooks:

systemprompt core playbooks show cli_files - File operations
systemprompt core playbooks show cli_skills - Skill management
systemprompt core playbooks show cli_contexts - Context management

Guides:

File Storage - Working with files
Building Extensions - Creating custom capabilities

Previous	Next
CLI Overview	Infra CLI