Skip to content

README.md

Latest commit

 

History

History
165 lines (110 loc) · 4.42 KB

README.md

File metadata and controls

165 lines (110 loc) · 4.42 KB
Raw

⭐ gitant-cli

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

License Release Go Version CI

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

🌐 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