Skip to content

v1.0.0

Choose a tag to compare

View all tags
@github-actions github-actions released this 17 Jun 19:59
· 11 commits to main since this release
v1.0.0
35b3921
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

The first stable release of the Pinecone CLI. pc is now generally available — the public-preview period is over, and the command surface can be considered stable moving forward.

This release consolidates everything since v0.4.6, including a round of pre-v1 finalization: new commands, a normalized flag and command structure, safer destructive operations, and a number of correctness fixes.

New features

  • pc index import — a new command group for bulk-loading vector data from a storage provider (S3, GCS, Azure) directly into a serverless index: start, list, describe, and cancel. Supports --error-mode and --integration-id for private buckets. (#91)
  • Key-based pc config — a generic, registry-driven configuration interface: pc config get|set|unset|list|describe <key>, with keys api-key, color, and environment. Adds the ability to view all settings at once (list) and inspect a setting's purpose, valid values, and sensitivity (describe). (#90)
  • Deletion confirmation prompts — destructive delete commands now prompt for confirmation before proceeding, with a --skip-confirmation flag to bypass them for automation. (#99)

Breaking changes

  • backup, restore, and collection moved under pc index. These were top-level commands and are now pc index backup, pc index restore, and pc index collection. Shipped without backwards-compatibility aliases. (#89) 
    pc backup ...        →  pc index backup ...
pc backup restore    →  pc index restore
pc collection ...    →  pc index collection ...
  • --index-name / --name normalization. --index-name (-i) now uniformly refers to an existing index, and --name (-n) names a resource being created. (#92)
    • pc index describe|delete|configure renamed their primary flag from --name to --index-name. --name/-n still works as a deprecated alias (prints a warning).
    • The --index-name shorthand changed from -n to -i on all other index commands.
    • The -i shorthand was removed from --id on vector query, import cancel, and import describe.
  • pc config commands renamed. get-api-key / set-api-key / set-color / set-environment are superseded by the key-based interface (pc config set api-key <value>, etc.). The legacy commands still work but are hidden and deprecated, and will be removed in a future release. (#90)
  • pc index record search --top-k is now required. It previously defaulted to 10; omitting it now returns a validation error. (#98)
  • --deletion-protection shorthands removed. The -p (on index configure) and -d (on index restore) shorthands were dropped; use the long-form --deletion-protection. (#99)
  • Delete commands prompt by default. Non-interactive scripts that relied on silent deletes must now pass --skip-confirmation (or --json, which also bypasses the prompt). pc index vector delete only prompts for --all-vectors; targeted --ids/--filter deletes proceed without a prompt. (#99)

Improvements

  • --body is now the documented primary input flag for record upsert and vector upsert; --file is retained as a hidden alias for now. (#98)
  • pc index configure now requires --index-name instead of silently passing an empty name to the API. (#89)
  • --metric and --dimension are now correctly forwarded when creating an integrated index (previously accepted but dropped). (#89)
  • Fixed column alignment in import, backup, and restore list tables, where ANSI color codes inflated column widths. (#91)
  • Clarified that --json must be set explicitly — it is not inferred from TTY state (only color is auto-suppressed on non-TTY output). The login, target, and auth interactive flows are the exception to better support agentic workflows. (#99)
  • --sparse-indices help text now specifies the element type (uint32 array). (#98)

Bug fixes

  • pc index collection list printed garbage for the dimension and vector-count columns (string(int32) rendered Unicode runes); now formatted correctly. (#99)
  • pc index configure --json was unreachable because the flag was never registered. (#99)
  • pc auth configure --project-id <unknown> panicked on an unmatched id; now fails with a clear message. (#99)
  • Corrected several help examples and "no target set" error hints that referenced nonexistent flags or the wrong subcommand. (#99)

Installation

# Install script (macOS / Linux):
curl -fsSL https://pinecone.io/install.sh | sh

# Homebrew (macOS, and Linux on Homebrew 4.5.0+):
brew install --cask pinecone-io/tap/pinecone

Already on a v0.4.x build? No migration is required — brew upgrade --cask pinecone, or re-run the install script to fetch and apply the latest version.

Full changelog: v0.4.6...v1.0.0

Changelog

  • e42a719 Add golangci-lint to codebase & CI (#96)
  • 0ef1e5e Add pc index import command group (#91)
  • a2b0329 Clean up backup, restore, and collection commands (#89)
  • d4f351d Clean up installation instructions in README.md (#97)
  • a754fe1 Final V1 Tweaks (#98)
  • 31f652c Normalize --index-name flag and shorthand conventions (#92)
  • 9fa3ef2 Refactor pc config to support key-based configuration and commands (#90)
  • 35b3921 Thorough review pass (#99)
  • 967e6ae Update .gitignore to exclude harness artifacts (#95)
  • dd913da V1 Finalization (#93)
  • dc8d8f2 V1 Finalization continued (#94)
Assets 10
Loading