clipflow-ai 1.0.0

package/README.md

@@ -0,0 +1,220 @@
+<div align="center">
+
+# **ClipFlow AI**
+
+### Your AI Content Pipeline
+
+**14 agents. One idea. Ready-to-post content.**
+
+[![Bun](https://img.shields.io/badge/runtime-Bun-f9f1e1?logo=bun&logoColor=000)](https://bun.sh)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+[![Platform](https://img.shields.io/badge/platform-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)]()
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-3178C6?logo=typescript&logoColor=white)]()
+[![Claude](https://img.shields.io/badge/AI-Claude-d97706?logo=anthropic&logoColor=white)]()
+
+Type one topic. 14 AI agents research, script, storyboard, design and package it into ready-to-post content for Instagram Reels, YouTube Shorts, TikTok and more.
+
+[**Star this repo**](https://github.com/Mohit-Bagri/Clipflow) if you find it useful :star:
+
+---
+
+[Overview](#-overview) · [Prerequisites](#-prerequisites) · [Installation](#-installation) · [Quick Start](#-quick-start) · [Pipeline](#-the-pipeline) · [Modes](#-modes) · [Keyboard](#-keyboard-shortcuts) · [Export](#-export--save) · [Structure](#-project-structure) · [License](#-license)
+
+</div>
+
+---
+
+## ▸ Overview
+
+ClipFlow AI is a terminal-based content pipeline that turns a single idea into production-ready short-form video content. Powered by Claude, it runs 14 specialized AI agents in sequence. Each one handles a different stage of the content creation process from research and scripting to art direction and cross-platform publishing.
+
+No browser tabs. No copy-pasting between tools. Just type your topic and let the agents work.
+
+### Why ClipFlow?
+
+| # | Feature | Description |
+|---|---------|-------------|
+| 1 | **Full Pipeline** | 14 purpose-built agents cover every step from brief to repurposing |
+| 2 | **Live Web Research** | Built-in MCP search server pulls real-time data via DuckDuckGo. No API key needed |
+| 3 | **Fact-Checking** | Dedicated agent verifies every claim before it reaches the script |
+| 4 | **Two Modes** | Fast mode for speed and Detailed mode for depth. Switch with one keystroke |
+| 5 | **Beautiful TUI** | OpenTUI-powered terminal interface with 60fps rendering, sidebar and markdown output |
+| 6 | **Real-Time Streaming** | Watch each agent think and write in real time. No waiting for batch results |
+| 7 | **One-Click Export** | Save the entire pipeline output as a structured markdown file with `Ctrl+S` |
+| 8 | **Cross-Platform** | Runs on macOS, Linux and Windows wherever Bun runs |
+| 9 | **Multi-Platform Output** | Generates content tailored for Instagram, TikTok, YouTube, Twitter/X and LinkedIn |
+| 10 | **Zero Config** | Detects your Claude authentication automatically. OAuth or API key |
+
+---
+
+## ▸ Prerequisites
+
+| Requirement | Purpose |
+|-------------|---------|
+| [Bun](https://bun.sh) | JavaScript/TypeScript runtime |
+| [Claude CLI](https://docs.anthropic.com/en/docs/claude-code) | AI backbone. Must be installed and authenticated |
+
+**Authentication** ClipFlow auto-detects your Claude credentials:
+- **Claude OAuth** Log in with `claude auth login` and it just works
+- **API Key** Set `ANTHROPIC_API_KEY` as an environment variable
+
+---
+
+## ▸ Installation
+
+### Install from source
+
+```bash
+git clone https://github.com/Mohit-Bagri/Clipflow.git
+cd Clipflow
+bun install
+bun run dev
+```
+
+### Coming soon: npm
+
+```bash
+npm install -g clipflow-ai
+clipflow
+```
+
+---
+
+## ▸ Quick Start
+
+```bash
+# Launch the interactive TUI
+bun run dev
+
+# Or pass a topic directly
+bun run dev "HDFC Bank chairman quit"
+```
+
+1. **Type your topic** anything from breaking news to niche explainers
+2. **Tab** to switch between Fast and Detailed mode
+3. **Enter** to launch the pipeline
+4. **Arrow keys** to browse agent outputs in real time
+5. **Ctrl+S** to save the full output as markdown
+
+> **Try:** `RBI rate cut` · `Apple Vision Pro 2` · `Zomato vs Swiggy` · `AI replacing jobs`
+
+---
+
+## ▸ The Pipeline
+
+ClipFlow runs 14 agents in sequence. Each agent receives the accumulated output of all previous agents, building context as the pipeline progresses.
+
+| # | Agent | Role | What It Does |
+|---|-------|------|-------------|
+| 1 | **The Planner** | Creative Brief | Turns your raw idea into a structured brief with audience, tone and platform targets |
+| 2 | **The Journalist** | Research | Searches the web for facts, data, expert opinions and surprising angles |
+| 3 | **The Scout** | Trend Analysis | Identifies trending formats, hashtags, competitors and optimal posting times |
+| 4 | **The Editor** | Fact-Check | Verifies every claim and statistic. Flags anything unconfirmed |
+| 5 | **The Creative Director** | Concepts | Develops 3 distinct creative angles and recommends the strongest one |
+| 6 | **The Attention Grabber** | Hooks | Writes 5 scroll-stopping hooks rated by stopping power |
+| 7 | **The Scriptwriter** | Script | Writes a full 30-45s script with timestamps, voiceover and visual cues |
+| 8 | **The Comedy Writer** | Humor | Injects meme references, humor beats and comedic timing into the script |
+| 9 | **The Art Director** | Visual Style | Defines color palette, typography, lighting and transitions |
+| 10 | **The Storyboarder** | Shot Plan | Maps every shot with camera angles, movement and on-screen text |
+| 11 | **The Producer** | Image Prompts | Writes AI image generation prompts for Midjourney, DALL-E and Flux for each shot |
+| 12 | **The Editor** | Assembly | Creates a second-by-second editing blueprint with audio mix and color grading |
+| 13 | **The Social Manager** | Publishing | Writes platform-specific captions, hashtags and A/B test plans |
+| 14 | **The Multiplier** | Repurpose | Adapts content for Twitter threads, LinkedIn, blog posts, carousels and newsletters |
+
+---
+
+## ▸ Modes
+
+| | **Fast** | **Detailed** |
+|---|----------|-------------|
+| **How it works** | Multiple agents collaborate together | Agents research independently then collaborate |
+| **Speed** | Around 3-4 minutes | Longer. Each agent takes its time |
+| **Quality** | Great for quick iterations | Best quality, deepest research |
+| **Best for** | Rapid ideation, testing topics | Final production-ready output |
+| **Switch** | Press `Tab` on the input screen | Press `Tab` on the input screen |
+
+---
+
+## ▸ Keyboard Shortcuts
+
+| Shortcut | Context | Action |
+|----------|---------|--------|
+| `Enter` | Input screen | Submit topic and start pipeline |
+| `Tab` | Input screen | Toggle between Fast and Detailed mode |
+| `Tab` | Pipeline screen | Toggle sidebar visibility |
+| `↑` `↓` | Pipeline screen | Navigate between agents |
+| `Ctrl+S` | Pipeline screen | Save full output as markdown file |
+| `Ctrl+P` | Anywhere | Open command palette |
+| `Ctrl+B` | Anywhere | Toggle sidebar |
+| `Ctrl+C` | Anywhere | Quit |
+| `q` | Pipeline screen | Quit |
+
+---
+
+## ▸ Export and Save
+
+Press **`Ctrl+S`** during or after the pipeline to save all agent outputs as a single markdown file.
+
+The exported file includes:
+- Topic and timestamp
+- Each completed agent's output under its own heading
+- Clean markdown formatting ready for sharing or editing
+
+Files are saved to your current working directory as:
+```
+clipflow_{topic}_{date}.md
+```
+
+---
+
+## ▸ Tech Stack
+
+| Layer | Technology |
+|-------|-----------|
+| **Runtime** | Bun |
+| **TUI Framework** | OpenTUI with Solid.js |
+| **AI** | Claude via CLI subprocess |
+| **Web Search** | Custom MCP server using DuckDuckGo |
+| **Language** | TypeScript |
+
+---
+
+## ▸ Project Structure
+
+```
+src/
+├── index.tsx                  # Entry point
+├── tui/
+│   ├── App.tsx                # Main OpenTUI application
+│   └── theme.ts               # Colors, spinner, logo
+├── lib/
+│   ├── agents.ts              # 14 agent definitions
+│   ├── pipeline.ts            # Pipeline runner
+│   ├── content-style.ts       # Shared prompt context
+│   └── types.ts               # TypeScript types
+├── auth/
+│   └── claude-credentials.ts  # Cross-platform Claude auth
+├── mcp/
+│   └── search-server.ts       # Web search MCP server
+└── providers/
+    ├── types.ts
+    ├── definitions.ts
+    ├── auth.ts                # Cross-platform auth resolver
+    └── index.ts
+```
+
+---
+
+## ▸ License
+
+[MIT](LICENSE). Use it, fork it, build on it.
+
+---
+
+<div align="center">
+
+Made with :heart: in India by **[Mohit Bagri](https://mohitbagri-portfolio.vercel.app)**
+
+[Star this repo](https://github.com/Mohit-Bagri/Clipflow) if ClipFlow helped you create something awesome
+
+</div>

package/bin/clipflow.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+import "../src/index.tsx";