README.md

zepctl

Command-line interface for administering Zep projects.

Installation

Homebrew (macOS/Linux)

brew tap getzep/zepctl https://github.com/getzep/zepctl.git
brew install zepctl

Binary Download

Download the appropriate binary from the releases page.

macOS users: If you see "zepctl cannot be opened because the developer cannot be verified", run:

xattr -d com.apple.quarantine /path/to/zepctl

Quick Start

# Configure your API key (you will be prompted to enter it securely)
zepctl config add-profile production

# Verify connection
zepctl project get

# List users
zepctl user list

Authentication

Set environment variables or use profiles:

Variable	Description
ZEP_API_KEY	API key for authentication
ZEP_API_URL	API endpoint (default: https://api.getzep.com)
ZEP_PROFILE	Override current profile

Configuration file location: ~/.zepctl/config.yaml

Commands

Command	Description
config	Manage profiles and settings
project	Get project information
user	Manage users
thread	Manage conversation threads
graph	Manage knowledge graphs
node	Manage graph nodes
edge	Manage graph edges
episode	Manage graph episodes
observation	List/get derived observation nodes
thread-summary	List incremental thread summaries
task	Monitor async operations
ontology	Manage graph schema
summary-instructions	Manage user summary instructions

Global Flags

Flag	Description
--api-key, -k	Override API key
--profile, -p	Use specific profile
--output, -o	Output format: table, json, yaml, wide
--help, -h	Display help

Documentation

See docs/cli.mdx for complete CLI reference.

License

See LICENSE for details.