Rename CLI binary to uspto and migrate install/update/config paths

Author: smcronin

.goreleaser.yaml

@@ -12,7 +12,7 @@ builds:
       - arm64
     ldflags:
       - -s -w -X github.com/smcronin/uspto-cli/cmd.version={{.Version}}
-    binary: uspto-cli
+    binary: uspto
 
 archives:
   - formats:
@@ -21,7 +21,7 @@ archives:
       - goos: windows
         formats:
           - zip
-    name_template: "{{ .ProjectName }}_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
+    name_template: "uspto_{{ .Version }}_{{ .Os }}_{{ .Arch }}"
 
 checksum:
   name_template: "checksums.txt"

CLAUDE.md

@@ -40,8 +40,8 @@ tests/
 
 ## Building
 ```bash
-go build -o uspto-cli .    # Build binary
-go install .               # Install to $GOBIN
+go build -o uspto .    # Build binary
+go install ./cmd/uspto     # Install `uspto` to $GOBIN
 go vet ./...               # Static analysis
 ```
 
@@ -64,5 +64,7 @@ All endpoints under /api/v1/
 
 ## Distribution
 ```bash
-go install github.com/smcronin/uspto-cli@latest
+go install github.com/smcronin/uspto-cli/cmd/uspto@latest
 ```
+
+

CONTRIBUTING.md

@@ -1,4 +1,4 @@
-# Contributing to uspto-cli
+# Contributing to uspto
 
 Thanks for your interest. This is a small personal project, so contributions follow a different process than most open-source repos.
 
@@ -33,7 +33,7 @@ A diff tells me *what* changed. The prompt tells me *why* and *whether I agree w
 ## Development
 
 ```bash
-go build -o uspto-cli .
+go build -o uspto .
 go vet ./...
 go test ./...
 go test ./tests/integration/ -v -count=1 -timeout 600s  # requires USPTO_API_KEY
@@ -42,3 +42,4 @@ go test ./tests/integration/ -v -count=1 -timeout 600s  # requires USPTO_API_KEY
 ## License
 
 By contributing, you agree that your contributions will be licensed under the MIT License.
+

EXAMPLES.md

@@ -1,20 +1,20 @@
 # Examples & Use Cases
 
-Real-world scenarios showing what you can do with `uspto-cli`. Every example runs in a single terminal command.
+Real-world scenarios showing what you can do with `uspto`. Every example runs in a single terminal command.
 
 ## See What Your Competitors Are Filing
 
 Pull every patent application filed by a company and export it to a spreadsheet:
 
 ```bash
 # Export all of Google's recent filings to CSV
-uspto-cli search --assignee "Google" --filed-within 1y --download csv > google_filings.csv
+uspto search --assignee "Google" --filed-within 1y --download csv > google_filings.csv
 
 # See what Apple is patenting in machine learning (CPC class G06N)
-uspto-cli search --assignee "Apple" --cpc G06N --granted --limit 50
+uspto search --assignee "Apple" --cpc G06N --granted --limit 50
 
 # Track a specific competitor's granted patents over time
-uspto-cli search --assignee "Samsung Electronics" --granted-after 2025-01-01 --all -f csv > samsung_2025.csv
+uspto search --assignee "Samsung Electronics" --granted-after 2025-01-01 --all -f csv > samsung_2025.csv
 ```
 
 ## Find Prior Art
@@ -23,13 +23,13 @@ Search by technology area, keywords, and classification codes to find relevant p
 
 ```bash
 # Search by title keywords
-uspto-cli search --title "solid state battery electrolyte" --granted --limit 20
+uspto search --title "solid state battery electrolyte" --granted --limit 20
 
 # Narrow by CPC classification
-uspto-cli search --cpc H01M10/0562 --filed-within 3y --all
+uspto search --cpc H01M10/0562 --filed-within 3y --all
 
 # Search by inventor name across all their filings
-uspto-cli search --inventor "Goodenough" --sort filingDate:desc
+uspto search --inventor "Goodenough" --sort filingDate:desc
 ```
 
 ## Read the Actual Patent Text
@@ -38,13 +38,13 @@ Extract claims, abstracts, and full specifications from granted patents — no P
 
 ```bash
 # Get the claims of a specific patent
-uspto-cli app claims 16123456
+uspto app claims 16123456
 
 # Get everything: abstract, claims, citations, full description
-uspto-cli app fulltext 16123456
+uspto app fulltext 16123456
 
 # Just the prior art citations (patent and non-patent references)
-uspto-cli app citations 16123456
+uspto app citations 16123456
 ```
 
 ## Download Every Document in a Patent's File History
@@ -53,13 +53,13 @@ Get all the PDFs — office actions, responses, drawings, everything the USPTO h
 
 ```bash
 # Download the entire file wrapper (all PDFs)
-uspto-cli app download-all 16123456
+uspto app download-all 16123456
 
 # Or just see what documents are available first
-uspto-cli app docs 16123456
+uspto app docs 16123456
 
 # Download a specific document by index
-uspto-cli app download 16123456 3
+uspto app download 16123456 3
 ```
 
 ## Trace a Patent Family Tree
@@ -68,10 +68,10 @@ Follow the chain of continuations, divisionals, and continuations-in-part to see
 
 ```bash
 # Build the family tree (follows parent/child chains)
-uspto-cli family 16123456 --depth 3
+uspto family 16123456 --depth 3
 
 # Get the continuity data for a single application
-uspto-cli app continuity 16123456
+uspto app continuity 16123456
 ```
 
 ## Due Diligence: Get Everything on a Patent
@@ -80,13 +80,13 @@ One command pulls together metadata, prosecution history, assignments, continuit
 
 ```bash
 # Full application summary (makes 5 API calls, returns unified view)
-uspto-cli summary 16123456
+uspto summary 16123456
 
 # Who owns it? Check assignment/transfer history
-uspto-cli app assignments 16123456
+uspto app assignments 16123456
 
 # What happened during prosecution?
-uspto-cli app transactions 16123456
+uspto app transactions 16123456
 ```
 
 ## Monitor PTAB Proceedings
@@ -95,16 +95,16 @@ Track inter partes reviews (IPRs), post-grant reviews, and other Patent Trial an
 
 ```bash
 # Find all IPR proceedings against a specific patent
-uspto-cli ptab search --type IPR --patent 9876543
+uspto ptab search --type IPR --patent 9876543
 
 # Get details on a specific proceeding
-uspto-cli ptab get IPR2023-00001
+uspto ptab get IPR2023-00001
 
 # Download all IPR decisions to a file
-uspto-cli ptab decisions --download csv > ipr_decisions.csv
+uspto ptab decisions --download csv > ipr_decisions.csv
 
 # Check appeal decisions
-uspto-cli ptab appeals "artificial intelligence"
+uspto ptab appeals "artificial intelligence"
 ```
 
 ## Download Bulk Patent Data
@@ -113,13 +113,13 @@ The USPTO publishes weekly data dumps of patent grants, applications, and more:
 
 ```bash
 # See what bulk data products are available
-uspto-cli bulk search "patent grant"
+uspto bulk search "patent grant"
 
 # List files in a specific product
-uspto-cli bulk files PTGRXML
+uspto bulk files PTGRXML
 
 # Download a specific weekly file
-uspto-cli bulk download PTGRXML ipg260101.zip -o ./data/
+uspto bulk download PTGRXML ipg260101.zip -o ./data/
 ```
 
 ## Export Data for Spreadsheets and Dashboards
@@ -128,13 +128,13 @@ Every command can output to CSV for Excel, Google Sheets, or any data tool:
 
 ```bash
 # CSV export for spreadsheet analysis
-uspto-cli search --assignee "Tesla" --all -f csv > tesla_portfolio.csv
+uspto search --assignee "Tesla" --all -f csv > tesla_portfolio.csv
 
 # Get filing counts by technology area
-uspto-cli search --assignee "Microsoft" --facets cpcSectionLabelName -f json
+uspto search --assignee "Microsoft" --facets cpcSectionLabelName -f json
 
 # Export PTAB proceedings
-uspto-cli ptab search --type IPR --all -f csv > all_iprs.csv
+uspto ptab search --type IPR --all -f csv > all_iprs.csv
 ```
 
 ## Let Your AI Agent Do Patent Research
@@ -143,10 +143,10 @@ The CLI is designed for AI agents. Any agent that can run terminal commands can
 
 ```bash
 # Agents get structured output with metadata
-uspto-cli search --title "LLM training" -f json --minify --quiet
+uspto search --title "LLM training" -f json --minify --quiet
 
 # Dry-run mode shows the API call without executing (useful for agent planning)
-uspto-cli search --assignee "OpenAI" --dry-run
+uspto search --assignee "OpenAI" --dry-run
 
 # Exit codes tell agents exactly what happened
 # 0=success, 2=bad input, 3=auth error, 4=not found, 5=rate limited
@@ -157,6 +157,8 @@ Agents can chain commands together to build complex research workflows — searc
 ## Getting Started
 
 1. Get a free API key at [data.uspto.gov](https://data.uspto.gov/apis/getting-started) (requires one-time ID verification)
-2. Install: `go install github.com/smcronin/uspto-cli@latest` or grab a binary from [releases](https://github.com/smcronin/uspto-cli/releases)
+2. Install: `go install github.com/smcronin/uspto-cli/cmd/uspto@latest` or grab a binary from [releases](https://github.com/smcronin/uspto-cli/releases)
 3. Set your key: `export USPTO_API_KEY=your-key-here`
-4. Start searching: `uspto-cli search --title "your technology" --limit 5`
+4. Start searching: `uspto search --title "your technology" --limit 5`
+
+