Open Source · Self-Hosted

Your AI assistant,
fully under your control.

Lightweight personal AI assistant. Chat via Telegram or Discord, invoke configured agents, delegate coding tasks to Claude / Codex CLIs, schedule jobs, approve risky actions โ€” all from one tiny self-hosted service.

Get Started View Docs GitHub
~23k lines of TypeScript Self-hosted MIT License
SkimpyClaw Web Dashboard
Auditability

Full auditability for every action

Every tool call, LLM request, approval decision, and cron execution is logged with timestamps, token counts, and cost data. Nothing happens in the dark.

  • JSONL-based audit traces for all agent interactions
  • Token counts and cost data per request
  • Searchable audit page with trigger badges and pagination
  • Optional Langfuse tracing for deeper observability
Read the audit docs
SkimpyClaw dashboard showing audit logs, tool calls, and cost tracking
Coding Agents

Delegate coding tasks to your favorite CLI

Hand a task off to Claude Code or Codex โ€” SkimpyClaw spawns the CLI, streams live output back to chat, and runs build / test validation before reporting. Discord threads can hold bidirectional interactive Claude sessions that `--resume` the same process across follow-ups.

  • Claude Code or Codex as worker CLIs
  • Monorepo-aware validation scoped to changed packages
  • Live stdout streaming and cost / token tracking
  • Bidirectional Claude sessions in Discord threads
Learn about coding agents
SkimpyClaw coding agent dashboard screenshot showing live task output and validation results
Agents

Configured agents with Discord shortcuts

Define multiple SkimpyClaw agents with their own identity, prompts, model, effort, and memory. Discord profiles add a channel-specific shortcut: invoke @reviewer or @researcher, bind the profile to a thread, and keep the conversation routed to that agent.

  • Config-backed agents under ~/.skimpyclaw/agents/<id>
  • Discord /agent commands for creating and listing profiles
  • @alias messages that create or reuse threads
  • Per-profile model, effort, and prompt overrides
Configure agents
R
@reviewer main ยท anthropic/claude-opus-4-7 ยท high
/agent prompt reviewer Focus on correctness issues and missing tests.
@reviewer review this release note before I publish
Task thread: reviewer โ†’ release-note-review
Security

Human approvals for risky commands

Tier-based risk classification for every bash command. Low-risk commands run automatically. Dangerous ones require explicit human approval via Telegram or Discord before execution.

  • Three-tier risk classification (informational, approval-required, dangerous)
  • Approve or deny commands from Telegram or Discord
  • Configurable TTL โ€” unanswered approvals expire automatically
  • Full audit trail of every approval decision
See approval tiers
Command approval queue with risk tiers and approve or deny actions
Observability

Usage & cost visibility

Track every token, every API call, every dollar. Usage summaries and per-model cost breakdowns in the dashboard โ€” so you always know what your AI assistant is spending.

  • Token and cost tracking per request
  • Usage summary and records in the dashboard
  • Per-model cost data via Langfuse integration
  • Browseable usage records with API access
Explore usage tracking
SkimpyClaw usage dashboard with costs, model breakdown, and recent calls
Flexibility

Bring your own model

Not locked into one runtime. Use Anthropic Claude or Codex-backed models, set defaults per agent, and override models per cron job.

  • Anthropic Claude and Codex-backed models
  • Exact model IDs plus focused Codex aliases
  • Prompt caching where the provider supports it
  • Per-agent and per-cron-job model overrides
Configure providers
SkimpyClaw model configuration showing multi-provider setup and model aliases
Extensibility

Extensible skills system

Write skills as simple markdown files with trigger patterns. Skills can invoke bash, file I/O, Fetch, MCP tools, or any combination โ€” activated automatically when patterns match.

  • Trigger-based activation from chat context
  • File I/O, bash, and Fetch built in
  • MCP tool integration via mcporter
  • Per-skill enable/disable and eligibility checks
Build a skill
SkimpyClaw skills system showing trigger patterns and tool integrations
Automation

Scheduled jobs & cron

Run agent prompts or shell scripts on any schedule. Morning digests, nightly backups, and weekly reports are configured in cron and can be triggered on demand from the dashboard.

  • Standard cron syntax with timezone support
  • Agent prompts or raw shell scripts
  • Trigger on-demand runs from the dashboard
  • Execution logs and digest output tracking
Set up schedules
SkimpyClaw scheduled jobs dashboard showing cron configuration and execution history

Get running in 30 seconds

Install globally, onboard, and start the daemon.

$ pnpm add -g skimpyclaw
$ skimpyclaw onboard
$ skimpyclaw start --daemon
Full Setup Guide