saturdayAI

Learn AI-assisted coding by creating your own personalized agent in 60 seconds.

Educational CLI tool that teaches non-agentic developers how to work with AI coding assistants through hands-on setup. No experience required.

For Developers Who've Never Used AI Agents

90% of developers have never used AI coding tools. They don't understand:

• What an "agent" is
• How context and state work
• Why skills matter
• How to interact with AI effectively

saturdayAI teaches through doing.

Run one command, answer 5 questions, and you'll have:

1. Your own personalized AI agent
2. Understanding of core agentic concepts
3. Ready-to-use configuration for multiple tools
4. Educational docs to level up

Quick Start

npx @saturdayai/create

That's it. The wizard asks 5 questions:

1. Agent name? (e.g., "CodeBuddy")
2. Your name?
3. Communication style? (Professional/Technical/Casual/Creative/GenZ)
4. What do you build? (Frontend/Mobile/Fullstack/Designer)
5. Token mode? (Saving/Full)

Result: Fully configured .claude/ directory optimized for Claude Code.

What You Get

1. Complete Agent Configuration

.claude/
├── CLAUDE.md               Your agent's personality & preferences
├── config/state/           Memory across sessions
├── skills/                 25+ expert knowledge modules
└── notes/                  Project context

Your agent knows:

• Your tech stack (Next.js, Flutter, etc.)
• Your code standards (TypeScript strict, no semicolons, etc.)
• Your communication preferences
• Your project structure and patterns

2. Comprehensive Documentation

9 educational guides in docs/:

• WHAT_IS_AN_AGENT.md - Understand agents from zero
• HOW_CONTEXT_WORKS.md - Context, tokens, efficiency
• UNDERSTANDING_SKILLS.md - 25 expert domains explained
• FREE_ALTERNATIVES.md - Try free tools first
• HOW_TO_USE_YOUR_AGENT.md - Daily workflows
• EXAMPLE_PROMPTS.md - 35+ copy-paste prompts
• TROUBLESHOOTING.md - Solve common issues
• STATE_MANAGEMENT.md - Long-term memory
• UPGRADE_TO_CLAUDE.md - When/why to pay

3. Token Efficiency (Save Money)

Before saturdayAI:

• Boot: 15,000+ tokens per conversation
• $20 Claude Pro: ~50 conversations/month
• Wasteful, expensive

After saturdayAI:

• Boot: ~1,500 tokens per conversation (90% reduction!)
• $20 Claude Pro: ~250 conversations/month
• Efficient, affordable

4. 25 Expert Skills

Your agent has expert-level knowledge in:

Frontend: Next.js, React, TypeScript, Tailwind, Web Performance Mobile: Flutter, State Management, UI/UX Animation: GSAP, Framer Motion, Scroll Interactions Architecture: Clean Code, SOLID, Design Patterns Performance: Bundle Optimization, Rendering, Core Web Vitals UI/UX: Design Systems, Responsive Design, Accessibility And 10+ more domains

Skills auto-load based on what you're working on.

Philosophy: Free First, Paid Later

saturdayAI promotes education through experience:

1. Setup your agent (5 minutes - free)
2. Learn the concepts (30 minutes - read docs)
3. Try free tools (2-4 weeks - GitHub Copilot, Gemini, OpenCode)
4. See the value (experience AI-assisted coding)
5. Upgrade when ready (Claude Code Pro $20/month - optional)

You don't need to spend money to get started.

Your .claude/ configuration works with:

• ✅ GitHub Copilot (Free tier: 2,000 completions/month)
• ✅ Google Gemini (Completely free, unlimited)
• ✅ OpenCode (Open source, local)
• ✅ Claude Code Pro ($20/month - best quality, upgrade later)

Read docs/FREE_ALTERNATIVES.md for setup instructions.

Who Is This For?

✅ You Should Use saturdayAI If:

• Never used AI coding tools - Perfect starting point
• Curious but overwhelmed - We'll guide you through it
• Budget-conscious - Start free, upgrade optionally
• Want to learn properly - Education-first approach
• Building real projects - Not just tutorials
• Value efficiency - Token optimization matters

⚠️ Skip saturdayAI If:

• Already using Claude Code - You don't need this
• Expert in AI agents - You can build this yourself
• Not coding regularly - Once a month = not worth it
• Just exploring - Try ChatGPT first

Features

🎨 Personality Customization

Your agent matches your communication style:

Professional: "I will implement the authentication system..."
Technical:    "Using bcrypt with 10 salt rounds for password hashing..."
Casual:       "Let's add login! I'll use Firebase Auth..."
Creative:     "Imagine a login flow that feels magical..."
GenZ:         "Yo let's build this auth system, fire 🔥"

🎯 Smart Skill Loading

Example: Building a Next.js app with animations

You: "Create a landing page with smooth scroll"

Agent detects keywords:
- "Next.js" → Loads nextjs-mastery
- "landing page" → Loads react-mastery
- "smooth scroll" → Loads scroll-interactions

Result: Expert-level code in Next.js + React + smooth scroll
Tokens used: ~2,000 (vs 15,000+ traditional)

📊 Token Efficiency Comparison

| Setup | Boot Tokens | Conversations/Month | Cost Per Conversation | |-------|-------------|---------------------|----------------------| | No optimization | 15,000 | ~50 | $0.40 | | saturdayAI | 1,500 | ~250 | $0.08 | | Savings | 90% | 5x more | 80% cheaper |

🚀 Multi-Project Support

Each project gets its own .claude/ directory:

~/projects/
├── portfolio/      → .claude/ (Next.js config)
├── mobile-app/     → .claude/ (Flutter config)
└── client-site/    → .claude/ (custom config)

No mixing of contexts, no confusion.

Commands

# Initialize agent (interactive wizard)
npx @saturdayai/create

# Or with CLI options
npx @saturdayai/create --name CodeBuddy --preset frontend

# View agent status
saturdayai status

# Add skills later
saturdayai add-skill gsap-mastery

# Configure settings
saturdayai config --list

# Get help
saturdayai --help

Real-World Examples

Example 1: Complete Beginner

Day 1: Run saturdayai, read docs (1 hour)
Day 2-7: Try GitHub Copilot Free (learn basics)
Week 2-4: Build portfolio project with Gemini
Month 2: See value, upgrade to Claude Code Pro
Result: Job-ready, confident with AI agents

Example 2: Professional Developer

Hour 1: Run saturdayai, configure agent
Hour 2: Start using Claude Code Pro
Week 1: 10+ hours saved on boilerplate
Month 1: 30% faster development
ROI: $20/month = 0.5 hours of work (saves 40+ hours)

Example 3: Freelancer

Project 1: Use free tools, learn workflows
Project 2: Upgrade to Claude, deliver faster
Project 3: Bill extra hours saved to client
Result: Competitive advantage, more clients

Educational Content

After setup, you'll have access to comprehensive guides:

Beginner Track (Start Here)

1. WHAT_IS_AN_AGENT.md - Understand AI agents (10 min read)
2. FREE_ALTERNATIVES.md - Try free tools (15 min setup)
3. HOW_TO_USE_YOUR_AGENT.md - Start coding (20 min read)

Intermediate Track

4. HOW_CONTEXT_WORKS.md - Master context & tokens (15 min)
5. UNDERSTANDING_SKILLS.md - Learn skill system (15 min)
6. EXAMPLE_PROMPTS.md - 35+ ready-to-use prompts (5 min)

Advanced Track

7. STATE_MANAGEMENT.md - Long-term memory (15 min)
8. TROUBLESHOOTING.md - Solve issues (reference)
9. UPGRADE_TO_CLAUDE.md - Evaluate paid tools (10 min)

Total learning time: 2-3 hours to master agentic development

Frequently Asked Questions

Q: Do I need to pay for anything?

No! Start with free tools:

• GitHub Copilot (free tier)
• Google Gemini (completely free)
• OpenCode (open source)

Upgrade to Claude Code Pro ($20/month) only when you want better quality.

Q: Will this work with [my tool]?

Your .claude/ configuration is designed for Claude Code but works with:

• ✅ GitHub Copilot (with manual context)
• ✅ Google Gemini (upload config)
• ✅ OpenCode (auto-reads config)
• ✅ Any tool that can read markdown files

Q: I'm a complete beginner. Is this too advanced?

No! saturdayAI is specifically designed for beginners.

• Simple 5-question wizard
• Plain English documentation
• No prior AI agent experience needed
• Step-by-step guides for everything

Q: How long does setup take?

• Setup wizard: 5 minutes
• Reading docs: 30-60 minutes (optional, recommended)
• First conversation: 2 minutes
• Total to productivity: Under 1 hour

Q: Can I use this for work/commercial projects?

Yes! MIT license, use however you want.

• Personal projects ✅
• Commercial projects ✅
• Client work ✅
• Open source ✅

Q: What if I already use Claude Code?

You might still benefit from:

• Token optimization techniques
• Skill organization patterns
• Educational content
• Multi-project templates

But if you're already expert-level, you might not need this.

Contributing

Found a bug? Want to add a feature? PRs welcome!

See CONTRIBUTING.md for guidelines.

Support

• Documentation: Check docs/ folder first
• Issues: https://github.com/saturdayai/create/issues
• Discussions: https://github.com/saturdayai/create/discussions
• Discord: Join saturdayAI community (link coming soon)

License

MIT - Use it however you want.

Acknowledgments

Built for developers who want to learn AI-assisted coding the right way:

• Education first, tools second
• Free alternatives promoted
• No forced upsells
• Community-focused

saturdayAI believes in teaching, not selling.

Ready to start?

npx @saturdayai/create

Happy coding! 🚀

Make Saturday your favorite coding day.