🔥 FORGE

Shape code. Ship faster. Forge the future.

---

FORGE is an intelligent development assistant that lives in your terminal. Powered by DeepSeek AI, it connects directly to your codebase and GitHub, helping you build, fix, and ship software faster than ever.

✨ Features

🎨 Beautiful Terminal UI

• Live streaming responses with syntax highlighting
• Animated spinners and progress bars
• Color-coded diffs and file trees
• Real-time command output

🔧 Local Development Superpowers

• Read/write/edit files with AI assistance
• Run commands and code in any language
• Search and navigate your codebase
• Automatic error fixing

🌐 GitHub Integration

• Clone and manage repositories
• Create branches and commits
• Open pull requests with AI-generated descriptions
• Fix issues automatically

🛡️ You're in Control

• Bring your own API keys (DeepSeek, GitHub)
• Confirm every destructive action
• Local workspace for privacy
• Open source and auditable

---

🚀 Quick Start

# Configure your keys
forge config set deepseek.api_key YOUR_KEY
forge config set github.token YOUR_TOKEN

# Check configuration
forge config list

# Ask questions about your code
forge ask "What does this function do?" --file src/main.py

# File system operations
forge fs ls                    # List directory contents
forge fs cat path/to/file.py   # Display file with syntax highlighting
forge fs search "*.py"         # Search for files

# GitHub integration
forge github auth --token YOUR_TOKEN    # Authenticate with GitHub
forge github list                       # List your repositories
forge github clone owner/repo           # Clone a repository
forge github status                     # Show git status
forge github commit "Your commit msg"  # Commit changes
forge github push                       # Push to remote
forge github pull                       # Pull from remote
forge github pr-list owner/repo        # List pull requests
forge github pr-create "PR Title" -r owner/repo -h feature-branch -b main
forge github issue-list owner/repo      # List issues
forge github issue-create "Issue Title" -r owner/repo -B "Description"

---

📦 Installation

Via pip

pip install forge-cli[github]  # with GitHub support
pip install forge-cli           # core only

Via Homebrew (macOS)

brew tap LebToki/forge
brew install forge

From source

git clone https://github.com/LebToki/forge-cli.git
cd forge-cli
pip install -e .[dev]

---

🎯 Why Forge?

Benefit	Description
Stay in the flow	No switching between browser, editor, and terminal
Real understanding	DeepSeek actually groks your codebase
End-to-end automation	From idea to PR in one command
Privacy first	Your keys, your data, your control
Beautiful experience	Terminal UI that doesn't suck

---

🤝 Contributing

We'd love your help! Check out CONTRIBUTING.md to get started.

• 💬 Join our Discord
• 🐛 Report bugs on GitHub Issues
• 📖 Improve the documentation

---

📚 Documentation

Full documentation at https://2tinteractive.com/demo/forge/docs/

• Getting Started
• Configuration
• GitHub Integration
• Tool Reference
• Examples

---

📄 License

MIT © Tarek Tarabichi from 2tinteractive

---

⭐ Show Your Support

If you find FORGE useful, please consider:

• Starring the repo ⭐
• Sharing it with friends 🚀
• Contributing code or docs 🤝

---

_{Built with 🔥 by developers who love the terminal}