Baro

Documentation

Everything you need to fork, customize, and publish products on Baro.

Get StartedBrowse docs

The Baro CLI is a single binary. Choose your preferred installation method.

bash
curl -fsSL https://baro-sync.com/baro-cli/install.sh | sh

Installs to ~/.local/bin/. Supports macOS and Linux (x86_64, arm64).

Step 2

Login#

Authenticate with your Baro account. This opens your browser for GitHub OAuth or email login.

bash
$ baro login
Opening browser for authentication...
✓ Logged in as yourname
Your session is stored locally. You only need to log in once.

Search for products from the command line or browse on the web.

bash
# Search for products
$ baro search "invoice tool"
  acme/invoice-tool       v2.1.0  Invoice generator with PDF export
  jane/invoice-tracker    v1.0.0  Track and manage invoices

# Fork a product
$ baro fork acme/invoice-tool
Forking acme/invoice-tool@2.1.0... done

# Fork a specific version
$ baro fork acme/invoice-tool@1.0.0

Forking downloads the full source code into a new directory. A .baro/manifest.json file tracks the origin for remake attribution.

Use any AI coding tool to modify the forked product. Baro is tool-agnostic.

bash
# Claude Code
$ claude "Add Korean invoice format"

# Cursor
# Open the directory in Cursor and use the AI assistant

# Aider
$ aider "Add dark mode support"

Products may include context files like CLAUDE.md, .cursorrules, or AGENTS.md to help AI tools understand the codebase.

Step 5

Publish#

Publish your own product to Baro. For forked products, use baro remake instead (see next section).

bash
$ baro publish --version 1.0.0
Packaging... 42 KB
Uploading... done
Published yourname/invoice-tool-ko v1.0.0

Requirements for publishing:

  • A build file (package.json, Cargo.toml, Makefile, etc.)
  • A README file
  • Description of at least 50 characters
  • No secrets or credentials in the source
New products start as pending_review and are manually reviewed before becoming public.

Publish with additional options:

bash
# Specify category and license
$ baro publish --version 1.0.0 --category developer-tools --license MIT
Step 6

Remake#

After forking and customizing a product, use baro remake to publish it as your own. This is a one-time command — after remaking, use baro publish for subsequent versions.

bash
# Fork a product, then publish as your own
$ baro fork acme/invoice-tool
$ cd invoice-tool

# Customize with AI...
$ claude "Add Korean invoice format"

# Publish your remake
$ baro remake --version 0.0.1 \
  --description "Invoice tool with Korean format" \
  --category developer-tools

Remaking as yourname...
Remaking from acme/invoice-tool → yourname/invoice-tool...
Creating product yourname/invoice-tool...
Uploading v0.0.1... done
Published yourname/invoice-tool@0.0.1
Remake tracked from acme/invoice-tool

If you already own a product with the same slug:

bash
# If you already own a product with the same slug
$ baro remake --version 0.0.1 --category developer-tools
Error: Slug 'invoice-tool' is already used by your product.
Use --slug <different-name> to pick a new one.

# Use --slug to pick a different name
$ baro remake --version 0.0.1 \
  --slug invoice-tool-ko \
  --category developer-tools
baro remake is one-time: it converts a fork into your own product. After that, use baro publish for updates. If you try baro publish on a fresh fork, it will remind you to use baro remake instead.

View, track, and manage your published products.

List your products from the CLI:

bash
$ baro products
yourname/invoice-tool   v2.1.0   [developer-tools]  published
  Invoice generator with PDF export
  Forks: 42  Rating: 4.5/5 (3)

yourname/my-app         v0.1.0   [productivity]     pending_review
  Task management tool

2 products

Filter by status:

bash
$ baro products --status published

Show current project identity:

bash
$ baro status
Product: yourname/invoice-tool
Version: 2.1.0
Origin:  acme/invoice-tool
Forked:  2026-01-15T10:30:00Z

Check for updates from fork origin:

bash
$ baro upstream
New version available: 3.0.0 (current: 2.1.0)
  Changelog: Added multi-currency support
  Run: baro fork acme/invoice-tool@3.0.0

Quick reference for commands, categories, and configuration.

Available categories:

bash
developer-tools  productivity   ai-agents      data-tools
devops           design-tools   communication  education
finance          other

The .baro/manifest.json file

This file tracks your product identity. It's created automatically on first publish or manually with baro init. Do not delete it — renaming your directory without this file will create a new product instead of updating the existing one.

Initialize a product with a custom slug:

bash
$ baro init --slug my-tool
Initialized baro product: my-tool
  Manifest: .baro/manifest.json

Search with options:

bash
# Sort by downloads or rating
$ baro search "invoice" --sort downloads --limit 10
$ baro search "tool" --sort rating --category developer-tools