ChittyCan

> chittycan learn. chittycan evolve. chittycan remember.
>
> chitty can, if you can.


Your completely autonomous network that grows with you—learning your patterns, evolving your workflow, and remembering your context across every session.

🎯 NEW: Your CLI Solution Provider (v0.4.3)

Stop memorizing syntax. Start speaking naturally.

ChittyCan now translates plain English into perfect CLI commands for GitHub, Docker, Kubernetes, and 14+ other tools.

``bash


No quotes needed—just type naturally


can gh clone my repo
can docker list running containers
can kubectl get pods in production
`

Learn more: can.mychitty.com | mychitty.com/can

$3

1. Beginner: can chitty gh clone repo (guided, explicit)
2. Intermediate: can gh clone repo (direct, confident)
3. Advanced: System learns your patterns and personalizes itself

$3

- 💬 Natural Language - Speak in plain English, no syntax memorization
- 🎯 14+ CLIs Supported - gh, docker, kubectl, git, aws, gcloud, terraform, and more
- 🧠 Learns Your Patterns - Tracks usage, suggests commands, grows with you
- 🔧 Custom Workflows - can chitty start coffee → triggers your coffee machine
- ✅ Guided Setup - Checks installation, auth, and walks you through configuration
- 📊 Usage Insights - can chitty insights shows your patterns

See full CLI Solution Provider docs →

---

🛠️ Complete Development Workflow

ChittyCan is a unified command-line tool that helps you manage every aspect of your development workflow:

- 📋 Project Tracking - Sync between Notion databases and GitHub Projects
- ☁️ Cloud Infrastructure - Manage Cloudflare Workers, DNS, KV, R2, Durable Objects
- 🗄️ Database Management - Neon PostgreSQL schemas, migrations, and deployments
- 🤖 AI Tools - Configure MCP servers and Claude Code settings
- 📁 File Management - Organize Google Drive and rclone remotes
- ⏱️ Smart Nudges - Shell hooks remind you to update trackers after git commits
- 🔄 Two-Way Sync - Keep Notion Actions and GitHub Issues in perfect sync

Quick Start

`bash


Install globally

npm install -g chittycan

Or run directly

npx chittycan

Initialize with interactive config

can config
`

🧠 Philosophy: Grow With Me

ChittyCan is built on a simple but powerful idea: your tools should learn from you, not the other way around.

It establishes your ChittyDNA—a living blueprint of how you work, what you prefer, and how you create.

$3

Every command you run, every pattern you create, every preference you express—ChittyCan observes and learns. Over time, it understands how you work and encodes it into your ChittyDNA.

$3

ChittyCan doesn't stay static. It adapts to your changing workflow, suggests optimizations, and grows more intelligent with each interaction—evolving your ChittyDNA as you grow.

$3

Context is preserved across sessions. ChittyCan remembers what you accomplished, what you configured, and what you prefer—your ChittyDNA persists, so you never start from scratch.

$3

You define the possibilities. ChittyCan amplifies your capabilities—learning your patterns, automating the repetitive, and scaling with your ambitions.

The result? A tool that becomes more powerful the longer you use it. Not through manual configuration, but through intelligent observation and evolution.

ChittyDNA means:
- Your workflow patterns are automatically recognized
- Your tool preferences inform smart routing decisions
- Your project context is preserved across sessions
- Your automation evolves with your needs
- Your productivity compounds over time

ChittyCan doesn't just remember commands—it understands you.

---

🏛️ Foundation Governance

ChittyCan operates under the ChittyFoundation Charter v0.1 - a comprehensive framework that protects human dignity, ownership, and fairness in AI systems.

$3

Your ChittyDNA belongs to you, not to ChittyCan. We obtain a scoped, revocable license—but you retain full ownership rights.

This means:
- ✅ Export Anytime: Your DNA is portable in PDX (Portable DNA eXchange) format
- ✅ Revoke Access: You can revoke ChittyCan's license and delete your DNA
- ✅ Privacy with Proof: We log hashes, not content—provable without exposure
- ✅ Attribution Chains: If we monetize, you get loyalty-based compensation for your DNA
- ✅ Ethical Exit: If we violate Foundation values, your exit rights activate immediately

$3

ChittyCan is pursuing ChittyCertified status in three tiers:

| Tier | Target | Status | Key Features |
|------|--------|--------|--------------|
| Bronze | v0.5.0 (Q1 2025) | 🟡 In Progress | DNA vaults, PDX export/import, privacy-preserving audits |
| Silver | v0.6.0 (Q2 2025) | 🔴 Planned | Attribution chains, fair-pay metrics, cross-platform DNA |
| Gold | v0.7.0 (Q3 2025) | 🔴 Planned | Zero-knowledge proofs, AI caretakers, global compliance |

$3

ChittyCan adheres to these non-negotiable principles:

1. You Own Your Data & DNA - Individuals own their decision patterns; orgs obtain licenses, not ownership
2. Portability by Default - Export, revoke, and migrate are baseline rights
3. Attribution → Compensation - Traceable contributions map to loyalty-based compensation
4. Privacy with Proof - Content can remain private while proofs remain verifiable
5. Human Safety & Dignity - No surveillance abuse, coercion, or harm
6. Transparency over Theater - Decisions and metrics are explainable and auditable
7. Diversity as Resilience - Multi-provider support prevents vendor lock-in

$3

- Foundation Compliance Document - Complete compliance roadmap
- PDX Specification - Technical spec for DNA portability
- ChittyFoundation Charter - Full governance framework

---

🚀 AI Gateway (New in v0.4.0!)

ChittyCan is now an OpenAI-compatible AI gateway - a drop-in replacement for OpenAI API that routes your requests through 8+ AI platforms with intelligent fallback chains, caching, and budget controls.

$3

- 💰 Cost Optimization - Route requests to cheapest provider, cache responses, set budget limits
- 🔄 Smart Fallback - If one provider fails, automatically try the next in your chain
- 🛡️ Resilience - Never get blocked by a single provider's outage
- 📊 Unified Interface - One API for OpenAI, Anthropic, Ollama, Groq, and more
- 🔒 Self-Hosted - Run your own gateway, keep your API keys private
- ⚡ Intelligent Routing - Route based on model capabilities, cost, or latency

$3

`python


Before (direct OpenAI)

import openai
openai.api_key = "sk-..."
response = openai.ChatCompletion.create(model="gpt-4", ...)

After (ChittyCan gateway)

import openai
openai.api_base = "http://localhost:8787/v1" # Your ChittyCan gateway
openai.api_key = "your-chittycan-token"
response = openai.ChatCompletion.create(model="gpt-4", ...) # Works identically!
`

That's it! Your existing code works unchanged. See MIGRATION_PLAYBOOK.md for full guide.

$3

`bash


Configure AI gateway

can config

Choose: New remote → AI Platform

Select platform:

1 / OpenAI - GPT-4, GPT-3.5, DALL-E

2 / Anthropic - Claude Sonnet, Opus, Haiku

3 / Ollama - Local models (Llama, Mistral, etc)

4 / Groq - Ultra-fast inference

5 / Replicate - Open source models

6 / Together - Inference API

7 / HuggingFace - 100k+ models

8 / Cohere - Command, Embed models

Configure gateway tier:

- Free: 1000 req/day, basic caching

- Pro: Unlimited, smart routing, fallback chains

- Team: Multi-user, usage analytics

- Enterprise: Self-hosted, SLA, support

`

$3

| Feature | Free | Pro | Team | Enterprise |
|---------|------|-----|------|------------|
| Requests/day | 1,000 | Unlimited | Unlimited | Unlimited |
| Basic Caching | ✅ | ✅ | ✅ | ✅ |
| Smart Routing | ❌ | ✅ | ✅ | ✅ |
| Fallback Chains | ❌ | ✅ | ✅ | ✅ |
| Budget Controls | ❌ | ✅ | ✅ | ✅ |
| Usage Analytics | ❌ | ❌ | ✅ | ✅ |
| Multi-user | ❌ | ❌ | ✅ | ✅ |
| Self-hosted | ❌ | ❌ | ❌ | ✅ |
| SLA & Support | ❌ | ❌ | ❌ | ✅ |

Pricing: Free tier available. Pro $29/mo, Team $99/mo, Enterprise contact sales.

$3

ChittyCan maintains 100% OpenAI API compatibility. We test every endpoint:

`bash


Run parity tests


export CHITTYCAN_TOKEN=your_token
export OPENAI_API_BASE=http://localhost:8787/v1
npm run test:parity
`

See tests/parity_py.py and tests/parity_node.js for test suite.

Report compatibility issues: Use the Parity Failure issue template - we fix within 24 hours.

Natural Language Commands

ChittyCan supports natural language for 14+ popular CLIs. Just tell it what you want in plain English (quotes optional):

`bash


GitHub CLI

can gh create a PR for my bug fix
can gh list all my open issues
can gh clone the repo chittyapps/chittycan

Docker

can docker list all running containers
can docker stop the nginx container
can docker show logs for app container

Git

can git commit all changes with message fixed auth
can git create a new branch called feature/login

Kubernetes

can kubectl get all pods in production namespace
can kubectl scale my deployment to 3 replicas

Quotes work too (useful for preserving exact phrasing)

can gh "create a PR titled 'Fix: auth bug'"
can git "commit everything with message 'v2.0 release'"

And more: npm, aws, gcloud, az, terraform, helm, cargo, pip, yarn, pnpm

`

How it works: ChittyCan proxies natural language commands to the full chitty CLI, which uses AI to interpret and execute the actual commands.

Note: Natural language commands require the full chitty CLI. If not installed, ChittyCan shows upgrade instructions.

Core Features

$3

Interactive rclone-style config for managing "remotes" (Notion databases, GitHub projects):

`bash


Open interactive config menu

can config

Add a Notion database remote

Choose: New remote → Notion database

Enter your database URL: https://notion.so/DATABASE_ID?v=VIEW_ID

Add a GitHub project remote

Choose: New remote → GitHub project

List all remotes

can remote list

Open a remote

can open tracker
can open tracker actions # Open specific view
`

$3

Get reminded to update your tracker after important commands:

`bash


Install zsh hooks

can hook install zsh

Now you'll get nudges after:

- git commit

- git merge

- wrangler deploy

- npm publish

Manual checkpoint

ai_checkpoint "Finished OAuth implementation"

Press Ctrl-G to open tracker anytime

`

$3

Keep your Notion Actions and GitHub Issues in perfect sync:

`bash


Setup sync (interactive)

can sync setup

Preview changes without applying

can sync run --dry-run

Run sync

can sync run

Check sync status

can sync status
`

Mapping:
- Notion Status "To Do" ↔ GitHub open + label:todo
- Notion Status "In Progress" ↔ GitHub open + label:in-progress
- Notion Status "Done" ↔ GitHub closed + label:done
- Notion Status "Archived" ↔ GitHub closed + label:archived

Conflict Resolution:
- Automatically detects when both Notion and GitHub changed
- Sets Sync State to "conflict" in Notion
- Manual resolution required

$3

`bash


Cloudflare Workers

can cf worker list
can cf worker deploy chittyauth --env production
can cf worker tail chittyconnect
can cf worker secrets set chittyauth JWT_SECRET

DNS

can cf dns list chitty.cc
can cf dns add chitty.cc A new-service 1.2.3.4

KV / R2

can cf kv list --namespace CACHE
can cf r2 list --bucket documents
`

$3

`bash


List databases

can neon db list

Run migrations

can neon migrate up
can neon migrate down

Schema diff

can neon schema diff production staging

Quick query

can neon query "SELECT * FROM identities LIMIT 5"
`

$3

`bash


List installed MCP servers

can mcp list

Install a new MCP server

can mcp install @modelcontextprotocol/server-filesystem

Configure Claude Code

can claude config
can claude remote add my-api https://api.example.com
`

$3

`bash


rclone integration

can rclone remote add gdrive
can rclone sync local:./docs gdrive:/ChittyOS/docs

Google Drive organization

can gdrive tree
can gdrive mkdir "ChittyOS/Projects"
`

Installation

$3

`bash
npm install -g chittycan
`

$3

`bash
git clone https://github.com/YOUR_USERNAME/chittycan
cd chittycan
npm install
npm run build
npm link
`

Configuration

All config is stored in ~/.config/chitty/config.json:

`json
{
"remotes": {
"tracker": {
"type": "notion-database",
"url": "https://notion.so/DATABASE_ID?v=VIEW_ID",
"databaseId": "DATABASE_ID",
"views": {
"actions": "https://notion.so/DATABASE_ID?v=VIEW_ID",
"projects": "https://notion.so/DATABASE_ID?v=VIEW_ID"
}
},
"chittyos": {
"type": "github-project",
"owner": "YOUR_USERNAME",
"repo": "chittyos",
"projectNumber": 1
},
"ai-gateway": {
"type": "ai-platform",
"platform": "openai",
"apiKey": "sk-...",
"model": "gpt-4",
"gateway": {
"accountId": "your-account-id",
"gatewayId": "your-gateway-id",
"enabled": true,
"tier": "pro",
"caching": true,
"smartRouting": true,
"fallbackChain": true,
"budget": {
"daily": 10,
"monthly": 300
},
"oauth": {
"enabled": true,
"scopes": ["chat", "embeddings"],
"openaiCompatible": true
}
}
},
"production": {
"type": "cloudflare",
"accountId": "your-cf-account",
"apiToken": "your-cf-token",
"workers": ["chittyauth", "chittyconnect"],
"zones": ["chitty.cc"]
},
"database": {
"type": "neon",
"projectId": "your-project-id",
"apiKey": "your-neon-key",
"databases": ["chittyos-core"]
},
"server": {
"type": "ssh",
"host": "server.example.com",
"user": "admin",
"port": 22,
"keyPath": "~/.ssh/id_rsa"
},
"claude": {
"type": "mcp-server",
"name": "@modelcontextprotocol/server-filesystem",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/files"]
}
},
"nudges": {
"enabled": true,
"intervalMinutes": 45
},
"sync": {
"enabled": true,
"notionToken": "secret_...",
"githubToken": "ghp_...",
"mappings": [
{
"notionRemote": "tracker",
"githubRemote": "chittyos"
}
]
}
}
`

$3

- notion-database - Notion database for project tracking
- github-project - GitHub Projects v2
- ai-platform - AI gateway (OpenAI, Anthropic, Ollama, Groq, etc.) 🆕
- cloudflare - Cloudflare Workers, DNS, KV, R2 🆕
- neon - Neon PostgreSQL databases 🆕
- ssh - SSH remote servers 🆕
- mcp-server - Model Context Protocol servers 🆕
- gdrive - Google Drive (via rclone)
- rclone - Any rclone-supported remote

Command Reference

$3

`bash
can config # Interactive config menu
can remote list # List all remotes
can open [view] # Open remote in browser
`

$3

`bash
can nudge now # Interactive nudge
can nudge quiet # Quick reminder
can checkpoint [message] # Save checkpoint
can checkpoints [limit] # List recent checkpoints
`

$3

`bash
can hook install zsh # Install zsh hooks
can hook uninstall zsh # Uninstall zsh hooks
`

$3

`bash
can sync setup # Configure sync
can sync run [--dry-run] # Run sync
can sync status # Show sync config
`

Setup Guides

$3

- Migration Playbook - Migrate from OpenAI to ChittyCan in 3 steps
- Competitive Analysis - How ChittyCan compares to alternatives
- Investor Pitch - Business case and roadmap
- Tactical Roadmap - What we're building and when

$3

- Multi-Model Architecture - Pop any AI model at any juncture
- GitHub App Setup - Create GitHub App for webhooks and API access
- ChittyOS Integration - Connect to ChittyOS ecosystem
- Extensions & Plugins - Extend ChittyCan functionality

$3

- Quick Start Guide - Get up and running in 5 minutes
- OS Support - Platform compatibility
- Full Documentation - Complete documentation

$3

- Contributing Guide - How to contribute code
- License Strategy - AGPL v3 + Commercial licensing explained
- Code of Conduct - Community guidelines
- Security Policy - Report vulnerabilities

Architecture

$3

`
chittycan/
├── src/
│ ├── commands/ # Command implementations
│ │ ├── config.ts # Interactive rclone-style config
│ │ ├── open.ts # Open remotes
│ │ ├── nudge.ts # Nudges and reminders
│ │ ├── checkpoint.ts # Checkpoint logging
│ │ ├── hook.ts # Shell hook management
│ │ └── sync.ts # Two-way sync
│ ├── lib/ # Core libraries
│ │ ├── config.ts # Config management
│ │ ├── notion.ts # Notion API client
│ │ ├── github.ts # GitHub API client
│ │ └── sync.ts # Sync worker
│ ├── types/ # TypeScript types
│ └── zsh/ # Shell snippets
│ └── snippets.zsh # Zsh hooks
├── bin/
│ └── can.js # CLI entry point
└── tests/ # Test suite
`

$3

Coming soon - web dashboard for:
- Visual project status
- Sync history and conflicts
- Infrastructure monitoring
- AI usage analytics

$3

Expose ChittyCan via Model Context Protocol:

`json
{
"mcpServers": {
"chittycan": {
"command": "can",
"args": ["mcp"]
}
}
}
`

Development Roadmap

$3

- [x] OpenAI-compatible AI gateway
- [x] 8 AI platform support (OpenAI, Anthropic, Ollama, Groq, etc.)
- [x] Gateway tier pricing (Free/Pro/Team/Enterprise)
- [x] Smart routing and fallback chains
- [x] Budget controls and caching
- [x] OAuth/API integration
- [x] Parity test suite (Python + Node.js)
- [x] Benchmark runner with Prometheus/Grafana
- [x] SSH, MCP Server, Cloudflare, Neon remote types

$3

- [ ] Self-hosted gateway deployment guide
- [ ] Advanced fallback strategies (model-specific)
- [ ] Request/response logging and replay
- [ ] Cost tracking dashboard
- [ ] Multi-user token management
- [ ] License change to AGPL v3 (with commercial option)

$3

- [ ] Cloudflare Workers deployment automation
- [ ] DNS configuration wizard
- [ ] KV/R2 operations
- [ ] Neon database schema migrations
- [ ] Infrastructure as code export

$3

- [ ] Web dashboard
- [ ] Real-time metrics (latency, cost, errors)
- [ ] Usage analytics per model/provider
- [ ] Budget alerts and notifications
- [ ] Historical data export

Contributing

Contributions welcome! See CONTRIBUTING.md for detailed guidelines.

Quick start:
1. Fork the repo
2. Create a feature branch
3. Make your changes
4. Add tests (maintain >80% coverage)
5. Run parity tests if touching API
6. Submit a PR

Important:
- First-time contributors must sign the CLA
- OpenAI API parity is critical - test everything
- Follow Conventional Commits
- Report parity failures within 24 hours

License

MIT

Philosophy

C.A.N. has dual meanings:

1. Chitty Autonomous Navigator - Emphasizes autonomous navigation across platforms
2. ChittyCan Completely Autonomous Network - Emphasizes the self-managing networked ecosystem

"Can you...?" → "Yes you can!"

ChittyCan embodies the spirit of empowerment - it's your completely autonomous network that seamlessly navigates across platforms, managing infrastructure, syncing data, and keeping you productive. When someone asks "Can you manage my cloud infrastructure from the command line?" or "Can you keep my Notion and GitHub in sync?", the answer is always a confident "Yes you can!"

The name works on multiple levels:
- 🤖 Completely Autonomous - Smart nudges, auto-sync, proactive reminders, self-managing agents
- 🌐 Network - Interconnected ecosystem of ChittyOS services + 80+ external platforms
- 🧭 Navigator - Seamlessly moves between Notion, GitHub, Cloudflare, Neon, Linear, and more
- ✅ Can - Empowering affirmation that you can accomplish anything

🚀 Model-Agnostic Networked Async Workstream

The killer feature: You can pop any AI model at any juncture in your networked async workstream and it just works.

$3

`
Your Workflow:
┌─────────────┐
│ Task 1 │ ─── Claude Sonnet (code generation)
└─────────────┘
│
┌─────────────┐
│ Task 2 │ ─── GPT-4 (analysis via ChittyConnect proxy)
└─────────────┘
│
┌─────────────┐
│ Task 3 │ ─── Llama Scout (routing via ChittyRouter)
└─────────────┘
│
┌─────────────┐
│ Task 4 │ ─── Claude Code (implementation)
└─────────────┘
`

Why this matters:
- 🎯 Right tool for the job - Use the best model for each specific task
- 💰 Cost optimization - Cheap models for simple tasks, powerful models for complex ones
- 🔄 No lock-in - Switch providers without changing your workflow
- ⚡ Async + Networked - Models work on different tasks simultaneously across the network
- 🛡️ Resilience - If one model is down, fallback chain kicks in automatically

$3

`bash


Step 1: ChittyRouter uses Llama Scout to triage incoming email

can router inbox process --agent triage

Step 2: ChittyConnect proxies to GPT-4 for document analysis

can connect proxy openai "Analyze this contract for key terms"

Step 3: Local Claude Code generates response

can router agent invoke response --email abc123 --draft

Step 4: ChittyID mints credential with any available model

can id credential issue --type VerifiedDocument

All working together in one async networked workflow ✨

``

$3

Any model can plug into:
- 📧 ChittyRouter agents - Email triage, priority, response, document analysis
- 🔌 ChittyConnect proxies - OpenAI, Anthropic, local models
- 🤖 MCP servers - Claude Code, Claude Desktop, custom tools
- 📝 Smart nudges - Local AI suggesting what to update
- 🔄 Sync engine - AI-powered conflict resolution
- 🎯 ChittyRegistry scripts - Model-driven automation

Related Projects

- ChittyOS - Legal technology platform
- ChittyID - Identity service
- ChittyConnect - AI-intelligent integration spine

---

Built with ❤️ for the ChittyOS ecosystem