A minimalist AI code generator for your recurring scripts. Generate Node.js, Python, or Bash scripts with built-in crontab support. Try it at https://croncode.ai
There are three ways to run the development environment locally. All methods support Hot Module Replacement (HMR) and provide a consistent experience.
Best for rapid UI development and general logic.
npm install
npm run devThe app will be available at http://localhost:5173.
Best for testing Cloudflare-specific features and ensuring production compatibility before deploying to Cloudflare Pages.
npm install
npm run dev:wranglerThis builds the project and runs it using the local Wrangler Pages emulator.
Best for a completely isolated environment or for contributors who prefer not to install Node.js locally.
docker compose upThe container automatically maps your host user's UID/GID to prevent permission issues with build caches. The app will be available at http://localhost:5173.
The application requires API keys for Google Gemini and/or Anthropic Claude to generate scripts. There are two ways to provide these:
You can create a .env file in the project root based on .env.example.
GEMINI_API_KEY=your_key_here
CLAUDE_API_KEY=your_key_hereWhen keys are provided via the environment, the server passes them to the client as defaults. On the first load, these keys are automatically saved to your browser's localStorage. This is ideal for private development instances where you want the app to be "ready-to-use" immediately.
If no environment variables are provided, or if you wish to override them, you can enter your API keys directly in the application's UI. These keys are stored only in your browser's localStorage. This allows users of a shared deployment to use their own personal API keys securely without them being stored on the server.
- AI Code Generation: Instantly generate logic for recurring tasks using Gemini or Claude.
- Natural Language Cron Builder: Configure complex schedules (e.g., "Every weekday at 6:00pm") using a command-palette style builder with live human-readable summaries and execution timelines.
- Hybrid VM Engine: Test Node.js scripts in WebContainers and Python/Bash scripts in a full x86 virtualized Linux environment (CheerpX) directly in the browser.
croncode.ai uses a Hybrid Verification Engine to allow you to test your generated scripts directly in the browser with high fidelity.
| Language | Engine | Technology | Best For |
|---|---|---|---|
| Node.js | WebContainer | @webcontainer/api |
Fast, native Node.js execution. |
| Python | Microterm | CheerpX (WebVM) | Standard Library & system tool testing. |
| Bash | Microterm | CheerpX (WebVM) | Full Linux coreutils fidelity (date, curl). |
- WebContainers (WebAssembly): Optimized for Node.js workflows. It provides a lightning-fast, Wasm-based micro-runtime that feels native to the browser but is limited to Node.js and basic shell commands.
- Microterm (x86 Virtualization): Powered by Leaning Technologies' CheerpX, this is a full x86 virtualization layer. It boots a real Linux guest (Debian/Alpine) using WebSocket-based chunk streaming, providing a 100% compliant environment for complex Bash and Python scripts that require system-level binaries.
- Framework: SvelteKit
- Styling: Tailwind CSS
- Language: TypeScript
- Build Tool: Vite
- Deployment: Cloudflare Pages
npm run dev: Start standard Vite development servernpm run dev:wrangler: Build and start local Cloudflare Wrangler emulatornpm run build: Build for productionnpm run preview: Preview production buildnpm run check: Run Svelte and TypeScript checksnpm run lint: Run Prettier and ESLintnpm run format: Run Prettier formattingnpm run test:docker: Run full Docker verification suite (builds and tests all 3 languages, ~90s)npm run test:docker:fast: Run immediate Docker verification (builds all languages but skips 60s cron check, ~20s)npm run test:docker:offline: Run verification suite with--network noneto test offline portability