MishraShardendu22

Puter AI CLI — AI skill for Claude Code

AI community

Free CLI AI assistant powered by Puter.js — stream GPT-4o, GPT-5.4, Claude & more directly from your terminal with zero OpenAI API keys, token pooling & auto-failover.

How to install Puter AI CLI

This entry records only its repository, not the path inside it, so there is no exact command to give. Open MishraShardendu22/puter-ai-cli and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Puter AI CLI does

Free CLI AI assistant powered by Puter.js — stream GPT-4o, GPT-5.4, Claude & more directly from your terminal with zero OpenAI API keys, token pooling & auto-failover.

Alternatives in AI

  • Claude Delegator — Delegate tasks to Codex GPT 5.2 directly from within Claude Code 909 ★
  • Free GPT4 WEB API — Not just GPT4 690 ★
  • Claudekit — by Carl Rannaberg - Impressive CLI toolkit providing auto-save checkpointing, code quality hooks, specificatio 633 ★

README

puter-ai-cli

Free CLI AI Assistant Powered by Puter.js

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Node Version](https://img.shields.io/badge/node-%3E%3D22.0.0-brightgreen.svg)](https://nodejs.org/) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x%20%7C%207.x-blue.svg)](https://www.typescriptlang.org/) [![CI](https://github.com/MishraShardendu22/puter-ai-cli/actions/workflows/ci.yml/badge.svg)](https://github.com/MishraShardendu22/puter-ai-cli/actions) [![GitHub Stars](https://img.shields.io/github/stars/MishraShardendu22/puter-ai-cli?style=social)](https://github.com/MishraShardendu22/puter-ai-cli)

Stream GPT-4o, GPT-5.4, Claude 3.5 & more directly in your terminal without requiring an OpenAI API key or paid subscription.


Why `puter-ai-cli`?

Most AI command-line tools require an expensive OpenAI or Anthropic API key with upfront billing. **`puter-ai-cli`** integrates with **Puter.js** to provide free, serverless AI queries directly from your terminal.

  • Zero OpenAI API Key Required: Powered entirely by Puter's hosted AI infrastructure.
  • Real-Time Token Streaming: Watch responses stream into stdout token-by-token.
  • One-Click Browser Auth: Automatically opens your browser on first run and persists your session securely.
  • Multi-Token Pooling & Auto-Failover: Configure multiple Puter accounts; the CLI automatically rotates between them (Round-Robin) and fails over seamlessly if one hits a rate limit!
  • Unix Pipeline Native: Pipe files, git diffs, and logs directly into prompts (cat file.c | mycli ask).
  • Production-Grade: Written in TypeScript with strict typing, comprehensive error normalization, and non-zero exit codes.

Quickstart

1. Installation

Clone and install dependencies:

git clone https://github.com/MishraShardendu22/puter-ai-cli.git
cd puter-ai-cli
npm install
npm run build
n