If you spend hours a day in Claude Code, you've probably seen the same rotating tips dozens of times. "Connect Claude to your IDE." "Use Attach Mode for large codebases." Developer vipulawl got tired of it and built claude-tips, an open-source tool that replaces those stale suggestions with fresh jokes, quotes, or random facts fetched from the internet.

How It Works

The tool doesn't monkey-patch Claude Code or inject into any processes. Instead, it writes directly to ~/.claude/settings.json using a native setting called spinnerTipsOverride. The configuration includes an array of custom tips and an excludeDefault flag that tells Claude Code to use only your replacements. Run the Python script once, and it persists across every session until you reset it.

Built-In Providers

Four content sources come included with zero API keys required. JokeAPI provides clean, programmer-friendly humor like "Why did the API return 418? It's a teapot." ZenQuotes supplies inspirational or witty quotes for those moments between debugging cycles. UselessFacts fetches random trivia to satisfy your curiosity while code compiles. You can also pass in custom strings via CLI flags if you want complete control over what appears on screen.

Auto-Refresh and Extensibility

For users who want variety without manual intervention, the tool supports watch mode with configurable intervals or cron job integration. A simple one-liner added to ~/.zshrc runs the script in the background every time you open a terminal, pulling fresh content automatically. Advanced users can create their own provider by writing a Python file with a fetch(count) function that returns a list of stringsβ€”perfect for pulling from news APIs, RSS feeds, or even local files.

Key Takeaways

  • No API keys needed for any built-in provider (JokeAPI, ZenQuotes, UselessFacts all free)
  • Pure stdlib Pythonβ€”no third-party dependencies beyond the standard library
  • Works via native Claude Code settings.json modification, not hacky process injection
  • MIT licensed and available on GitHub at github.com/vipulawl/claude-tips

The Bottom Line

This is exactly the kind of small quality-of-life tool that the open-source community nailsβ€”identifying a minor friction point and solving it elegantly without overengineering. If you're already living in Claude Code daily, five minutes of setup means months of actually funny tips instead of robotic placeholders. Worth bookmarking.