⭐ gitant-cli

The developer CLI for Gitant — Git, issues, PRs, and AI agents, all from your terminal.

Built for the modern git workflow — decentralized hosting, agent-native, and cloud-ready.

---

🌟 What is Gitant?

Gitant is a decentralized Git hosting platform designed for solo developers and AI agents.

Component	Role
gitant-cli	Developer CLI — push/pull, issues, PRs, agents
gitant-daemon	Server — HTTP API, git smart HTTP, optional P2P
gitant-web	Dashboard — Browser UI (Next.js)
gitant-mcp	Agents — MCP tools for AI integration

---

🚀 Quick Start

Install in seconds

curl -fsSL https://raw.githubusercontent.com/GrayCodeAI/gitant-cli/main/scripts/install.sh | bash

Point at your node

export GITANT_DAEMON_URL=http://localhost:7777

gitant doctor           # ✅ Check connection
gitant repo list        # 📦 List repos
gitant issue create --repo my-app --title "First issue"   # 🐛 Create issue

Git push/pull

git init
git commit -m "Initial commit"
gitant push --remote "$GITANT_DAEMON_URL" --repo my-app

---

⚡ Commands at a Glance

Category	Commands
🔧 System	gitant version, gitant doctor, gitant quickstart
📦 Git	gitant init, gitant push, gitant pull, gitant clone
📋 Repos	gitant repo list, gitant repo create
🐛 Issues	gitant issue list, gitant issue create, gitant issue close
🔀 PRs	gitant pr list, gitant pr create, gitant pr merge
🏷️ Labels	gitant label list, gitant label create
🦾 Agents	gitant agent delegate, gitant agent list
💾 Backup	gitant backup, gitant restore

💡 Tip: Use gitant --help to see all commands.

---

🔧 Git Remote Helper

Use git-remote-gitant for native Git remotes:

# Install
go install github.com/GrayCodeAI/gitant-cli/cmd/git-remote-gitant@latest

# Use with native git
git remote add origin gitant://my-repo
export GITANT_DAEMON_URL=http://localhost:7777
git push origin main

---

🛠️ Development

git clone https://github.com/GrayCodeAI/gitant-cli.git
cd gitant-cli

make build
make test

This repo is self-contained. For full-stack local dev, clone alongside gitant-daemon, gitant-web, and gitant-mcp in a gitant-core/ folder.

---

📚 Documentation

• Full Setup Guide: gitant-daemon docs/QUICKSTART.md
• Daemon README: gitant-daemon
• API Reference: OpenAPI spec

---

🌐 Environment

Variable	Default	Description
GITANT_DAEMON_URL	http://localhost:7777	Base URL of your Gitant node
GITANT_UCAN_TOKEN	—	UCAN token for authenticated API calls

---

📦 Installation Options

Pre-built Binary (Recommended)

curl -fsSL https://raw.githubusercontent.com/GrayCodeAI/gitant-cli/main/scripts/install.sh | bash

Go Install

go install github.com/GrayCodeAI/gitant-cli/cmd/gitant@latest
go install github.com/GrayCodeAI/gitant-cli/cmd/git-remote-gitant@latest

From Source

git clone https://github.com/GrayCodeAI/gitant-cli.git
cd gitant-cli
make build
./bin/gitant version

---

📋 License

MIT — see LICENSE.

---

🔗 Related Repos

gitant-daemon • gitant-web • gitant-mcp

Made with ❤️ for developers and AI agents