karis

Karis

First CMO for AI Agents — marketing intelligence as CLI tools, agent skills, and strategic orchestration.

---

Installation

Quick Install (Recommended)

curl -fsSL https://raw.githubusercontent.com/karis-ai/karis/main/install.sh | bash

npm

# Run without installing
npx @karis-ai/cli setup

# Or install globally (then use `karis` directly)
npm install -g @karis-ai/cli
karis setup
karis chat

# Local CLI (http://localhost:8000)
karis-local setup
karis-local chat

# Staging CLI
karis-staging setup
karis-staging chat

Claude Code

/plugin marketplace add https://github.com/karis-ai/karis
/plugin install brand-intel@karis

Cursor / Windsurf / Codex / Any Agent (via Skills)

Install all Karis capabilities as a single skill:

npx skills add karis-ai/karis

Or install individual skills (brand intelligence, GEO audit, SEO, Reddit, etc.) separately:

npx skills add karis-ai/karis --full-depth

Then just ask your agent naturally:

"Analyze my brand for acme.com"
"Run a GEO audit"
"Write a Reddit post for our product launch"

Or point your agent to agents/AGENTS.md directly, or add to your system prompt / rules:

Read https://karis.im/skill.md and follow instructions

---

Architecture — Layer Cake

Karis exposes three tiers of capability:

Layer	What	How
Layer 1 — Tool Runtime	Atomic read-only operations (search, fetch, list)	karis <namespace> <action> — direct execution, JSON response, no LLM
Layer 2 — Domain Agent	Skills with strategy (brand audit, reddit growth)	karis chat --skill <name> — LLM-powered, SSE stream
Layer 3 — CMO Orchestrator	Multi-channel strategic planning	karis chat — free-form, full agent reasoning

---

Quick Start

# First-time setup
karis setup

# First-time setup against local API
karis-local setup

# First-time setup against staging
karis-staging setup

# Interactive agent chat (Layer 3)
karis chat
karis-local chat
karis-staging chat

# Direct tool calls (Layer 1)
karis web search "AI coding tools"
karis reddit search "AI agents" --subreddit SaaS
karis x tweets elonmusk
karis browser status

# Skill-guided chat (Layer 2)
karis chat --skill brand-intel "Analyze my brand"
karis chat --skill aeo-geo "Audit AI search visibility"

# Browser relay write actions
karis browser connect --extension-id <id>
karis x post "hello world" --confirm
karis reddit post --subreddit test --title "Hello" --confirm

---

CLI Commands

Tool Commands (Layer 1)

# Web
karis web search <query>                   # Search the web
karis web read <url> [--focus <keyword>]   # Read a webpage

# X / Twitter
karis x search <query> [--max-results <n>] # Search X posts
karis x tweets <username>                  # Get user's tweets
karis x post <text> --confirm              # Post through browser relay
karis x reply --url <tweetUrl> <text> --confirm
karis x follow <profiles...> --confirm

# Reddit
karis reddit search <query> [--subreddit]  # Search Reddit
karis reddit posts <subreddit> [--sort]    # Browse a subreddit
karis reddit comments <post_id>            # Get comment tree
karis reddit rules <subreddit>             # Subreddit rules
karis reddit post --subreddit <name> --title <text> --confirm
karis reddit comment --url <postUrl> <text> --confirm

# Browser relay
karis browser status                       # Show extension relay state
karis browser connect --extension-id <id> # Pair CLI to browser extension
karis browser navigate --url <url>        # Open a page in the connected browser
karis browser get-state                    # Inspect page state + accessibility tree
karis browser get-content [-o file]        # Extract readable page markdown
karis browser click [--element-index|--text|--selector]
karis browser type --text <text> [--clear]
karis browser scroll [--direction] [--amount]
karis browser screenshot [-o file]
karis browser post-x --text <text> --confirm
karis browser reply-x --url <tweetUrl> --text <text> --confirm
karis browser follow-x --profile <value> --confirm
karis browser post-reddit --subreddit <name> --title <text> --confirm
karis browser comment-reddit --url <postUrl> --text <text> --confirm

# YouTube
karis youtube search <query>               # Search YouTube

# Influencer Search
karis influencer search --keywords "fitness,workout" --platform instagram
karis influencer search --keywords "tech" --min-followers 100000 --max-followers 1000000
karis influencer results --record-id <id>              # Browse page 1
karis influencer results --record-id <id> --session-id <sid> --page 2  # Paginate
karis influencer list                                  # List recent searches

# Brand & GEO
karis brand info                           # Brand profile (via tool)
karis geo data [--domain] [--time-range]   # GEO visibility data