Provenly CLI — Developer Intelligence Tool

prov is a command-line tool for analyzing code repositories, managing developer profiles, and generating trust signals.

Installation

macOS/Linux (Homebrew)

brew install provenly

Direct Binary Download

curl -fsSL https://provenly.live/install.sh | bash

Docker

docker run provenly/cli analyze .

Build from Source

git clone https://github.com/devup-io/prov
cd prov
go build -o prov .
sudo mv prov /usr/local/bin/

Quick Start

# 1. Authenticate
prov login

# 2. Connect a source
prov connect

# 3. Import a repository
prov import

# 4. Analyze current repo
prov analyze

# 5. Upload a snapshot
prov push

Commands

Authentication

• prov login — Authenticate with Provenly
• prov logout — Remove local credentials
• prov whoami — Show the active account

Sources

• prov connect — Interactive source picker
• prov disconnect <source> — Unlink a provider
• prov sources — List connected and available providers

Projects

• prov init — Initialize .provenly/config.json
• prov status — Show current project and account status
• prov sync — Sync project metadata
• prov push — Upload analysis snapshot and register the project

Repository Import

• prov import — Interactive repository picker
• prov import owner/repo — Import a GitHub repository
• prov import github:owner/repo — Import from an explicit provider

Analysis

• prov analyze [repo-url] — Analyze repository trust score and quality
  • --deep — Advanced semantic analysis
  • --private — Local-only, no cloud sync
• prov profile [username] — Show developer profile

AI & Insights (Coming Soon)

• prov ask "question" — Query AI about your code
• prov insight — Generate semantic intelligence report

Advanced (Coming Soon)

• prov compare user1 user2 — Compare developers
• prov find "criteria" — Search developers
• prov org scan — Analyze organization
• prov export --pdf — Generate shareable proof

Configuration

Configuration stored in .provenly/config.json:

{
  "project_name": "my-project",
  "analysis_depth": "standard",
  "team": "default",
  "sync_results": true,
  "ignore_paths": ["node_modules", ".git", "dist"]
}

Credentials stored in ~/.provenly/credentials.json (encrypted, not committed to git).

Development

# Clone repository
git clone https://github.com/devup-io/prov
cd prov

# Build
go build -o prov .

# Test
go test ./...

# Run
./prov analyze

Project Structure

.
├── main.go              # CLI entry point
├── cmd/                 # Command definitions
│   ├── root.go
│   ├── login.go
│   ├── analyze.go
│   └── profile.go
├── internal/
│   ├── api/             # Backend API client
│   ├── config/          # Config management
│   └── cache/           # Local caching
└── go.mod

Architecture

• Local Analysis: Git history, code structure parsing (no API calls)
• API Sync: Results sent to Provenly backend for scoring/verification
• Caching: 24-hour cache in ~/.provenly/cache/
• Credentials: OS keychain or encrypted file storage

Roadmap

• [ ] Phase 1: Auth, analyze, profile commands
• [ ] Phase 2: Config management, local caching
• [ ] Phase 3: AI-powered insights (prov ask)
• [ ] Phase 4: Team commands (prov org scan)
• [ ] Phase 5: Marketplace integration
• [ ] Phase 6: Web-based CLI integration

Contributing

Contributions welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Submit a pull request

License

MIT License — See LICENSE file

Support

• Documentation: https://docs.provenly.io
• Issues: https://github.com/devup-io/prov/issues
• Discord: https://discord.provenly.io