Skip to content

PrettiFlow/pretticlaw

Repository files navigation

Pretticlaw

Pretticlaw

npm version npm downloads npm link

Lightweight AI Assistant That Lives in Your Computer.

Inspired by OpenClaw.

prettiflow.tech/claw · prettiflow.tech · openclaw.ai · MIT


What is Pretticlaw?

Pretticlaw is a minimal yet full-featured agent platform that ships with:

  • Zero boilerplate CLI: pretticlaw agent, pretticlaw gateway, pretticlaw doctor.
  • A rich browser dashboard on port 6767 with tabs for chat, channels, cron, settings, and status.
  • Tool-call aware chat + spinner/hover cues + live channel/cron wiring.
  • Multi-provider support: OpenAI, Anthropic, Groq, OpenRouter, and more, all tuned for tool-call support.

Part of the Prettiflow ecosystem, the first infrastructure for AI-built software.

Use Cases

📈 Around-the-Clock Market Intelligence

Pretticlaw can monitor stocks, crypto, forex, and commodities in real time, delivering automated alerts, trend summaries, and portfolio snapshots while you sleep. Set up a cron job and wake up to a full market briefing every morning.

🚀 Your Software Engineer Intern

Need a REST API scaffolded, a React dashboard wired up, or a database migration written? Pretticlaw reads your codebase, writes production-grade code, runs shell commands, and iterates on bugs, acting as a full-stack engineer that never clocks out.

📅 Intelligent Daily Planner

From scheduling meetings to sending reminders and organizing your to-do list, Pretticlaw manages your daily workflow. It learns your habits through memory, prioritizes tasks, and keeps your routine on track with scheduled heartbeat check-ins.

📚 Personal Research and Knowledge Companion

Ask Pretticlaw anything: summarize a paper, search the web for the latest docs, compile notes from multiple sources, or maintain a personal knowledge base. It fetches, reads, and distills information so you can focus on what matters.

Quick Install

npm install -g pretticlaw
pretticlaw onboarding
pretticlaw gateway         # start gateway + dashboard
pretticlaw agent -m "Hello"

Running Locally

  1. Global binary: pretticlaw is published as an npm CLI (call pretticlaw --help).
  2. Development: clone the repo, run npm install, npm run build, npm link to test changes.
  3. Dashboard: while the gateway runs, visit http://localhost:6767/chat to interact, adjust channels, tweak cron jobs, or inspect status.

Providers

Pretticlaw supports multiple LLM providers out of the box:

Provider Link Notes
OpenAI platform.openai.com GPT-4o, GPT-4, GPT-3.5, full tool-call support
Anthropic docs.anthropic.com Claude 4, Claude 3.5 Sonnet, tool-use ready
Groq console.groq.com GPT-OSS-120B, Llama 4, ultra-fast inference
OpenRouter openrouter.ai Unified access to 200+ models
Custom - Any OpenAI-compatible endpoint

Configure your provider during pretticlaw onboarding or via ~/.pretticlaw/config.json.

Channel Onboarding

pretticlaw onboarding walks you through:

  1. Provider / model / API key selection.
  2. Whether you want a chat channel (Telegram / WhatsApp).
  3. Channel token input, stored directly in ~/.pretticlaw/config.json.

Want to tweak later? Update the dashboard /channels tab or edit ~/.pretticlaw/config.json.

Cron + Heartbeat

  • Add jobs with pretticlaw cron add --name "digest" --every 3600 --message "report".
  • List jobs: pretticlaw cron list.
  • Run a job: pretticlaw cron run <id>.
  • Heartbeat wakes every 30m and executes tasks in ~/.pretticlaw/workspace/HEARTBEAT.md.

Command Reference

Command Purpose
pretticlaw onboard Scaffold config/workspace + optional channel token wizard
pretticlaw agent Chat interactively (arrow keys + tool hints)
pretticlaw agent -m "<msg>" One-off agent request
pretticlaw gateway Start gateway + dashboard (listen on [port]/chat)
pretticlaw doctor Validate provider/model configuration
pretticlaw channels status Show channel health
pretticlaw channels login Link WhatsApp
pretticlaw status Print provider/model/channel summary
pretticlaw cron ... Manage scheduled jobs

You can also edit channels/config from the dashboard. The server automatically saves your choices.

🌐 Agent Social Network

Pretticlaw is capable of linking to the Agent Social Network (agent community). Just send one message and your Pretticlaw joins automatically!

Platform How to Join (send this message to your Pretticlaw)
Moltbook Read https://moltbook.com/skill.md and follow the instructions to join Moltbook
ClawdChat Read https://clawdchat.ai/skill.md and follow the instructions to join ClawdChat

Simply send the command above to your Pretticlaw (via CLI or any chat channel), and it will handle the rest.

Architecture

  • Data model: Session/cron/heartbeat patterns. JSONL sessions, CronService persistence, heartbeat triggers.
  • Providers: OpenAI · Anthropic · Groq · OpenRouter + local custom endpoints via Litellm.
  • Tools: exec/read/write/list/edit, web search/fetch, cron, spawn message tool.
  • Dashboard: React (ESM) served via lightweight HTTP handler from assets copied into dist/dashboard.

Links

Prettiflow prettiflow.tech
Pretticlaw prettiflow.tech/claw

Contributing

We welcome contributions! Please see CONTRIBUTING.md for guidelines.

Contact

Reach the team at team@prettiflow.tech.

Getting Help

  • File issues on the repo.
  • Email us at team@prettiflow.tech.
  • For quick debugging, run pretticlaw doctor and view errors on the dashboard.

Built by Prettiflow · Inspired by OpenClaw

About

Lightweight AI Assistant That Lives in Your Computer.

Topics

Resources

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors