← Back to Skills Marketplace
mrlynn

Voyage AI CLI

by Michael Lynn · GitHub ↗ · v1.4.0
cross-platform ⚠ suspicious
1856
Downloads
0
Stars
1
Active Installs
1
Versions
Install in OpenClaw
/install voyageai-skill
Description
Voyage AI embedding and reranking CLI integrated with MongoDB Atlas Vector Search. Use for: generating text embeddings, reranking search results, storing embeddings in Atlas, performing vector similarity search, creating vector search indexes, listing available models, comparing text similarity, bulk ingestion, interactive demos, and learning about AI concepts. Triggers: embed text, generate embeddings, vector search, rerank documents, voyage ai, semantic search, similarity search, store embeddings, atlas vector search, embedding models, cosine similarity, bulk ingest, explain embeddings.
Usage Guidance
This skill is a coherent CLI wrapper for Voyage AI + MongoDB Atlas Vector Search, but check a few things before installing: 1) The package installs globally via npm — verify the 'voyageai-cli' package and its maintainer (npm listing and GitHub repo) so you trust what code will be run on your machine. 2) You must provide VOYAGE_API_KEY; the SKILL.md also references MONGODB_URI for DB operations but that env var is not declared — only set MONGODB_URI when you intend to allow the CLI to connect to your Atlas cluster. 3) The CLI can persist an API key via 'vai config', which writes to your home directory; prefer least-privilege API keys and consider using ephemeral or scoped credentials. 4) The README instructs adding shell completion to ~/.bashrc or zsh completion directories — these modify your shell config. 5) If you need higher assurance, inspect the npm package code (postinstall scripts, config storage location) or run the CLI in an isolated environment (container or separate account) before giving it production credentials.
Capability Analysis
Type: OpenClaw Skill Name: voyageai-skill Version: 1.4.0 The skill is classified as suspicious due to its installation method and system modifications. It requires a global npm package installation (`npm install -g voyageai-cli`) and includes instructions to modify the user's shell configuration (`~/.bashrc`) for shell completions, both found in `SKILL.md`. While these actions are common for CLI tools and are for a stated, legitimate purpose, they involve high-privilege operations that could be leveraged for unintended system changes or persistence if the underlying package were compromised or the agent were prompted maliciously.
Capability Assessment
Purpose & Capability
The name/description, required binary ('vai'), and VOYAGE_API_KEY align with a CLI that calls Voyage AI and Atlas APIs. Minor mismatch: the SKILL.md documents use of MONGODB_URI (for storing/searching) but that env var is not declared in the skill's requires.env; otherwise required pieces make sense for the stated purpose.
Instruction Scope
SKILL.md is an instruction-only wrapper that tells the agent to run the 'vai' CLI with commands for embedding, indexing, search, reranking, config management, completions, and ingestion. These steps stay within the stated domain. The instructions do include writing shell completion files (~/.bashrc, ~/.zsh/completions) and using 'vai config' to persist an API key in the user's config — expected for a CLI but worth noting. No instructions attempt to access unrelated files or external endpoints beyond the Voyage/MongoDB services documented.
Install Mechanism
Install uses npm (package: voyageai-cli, global installation). npm is an expected distribution channel for a Node.js CLI. This is moderate-risk relative to a curated package store but is proportionate and consistent with the skill's purpose; there are no ad-hoc download URLs or archive extractions in the spec.
Credentials
The skill declares VOYAGE_API_KEY as required (appropriate). However, SKILL.md refers to MONGODB_URI for store/search/index operations but MONGODB_URI is not listed in requires.env. The absence of an explicit primaryEnv (VOYAGE_API_KEY could reasonably be primary) and the undocumented optional env variable is a documentation/integration inconsistency the user should be aware of before installing.
Persistence & Privilege
always:false (default) and disable-model-invocation:false — normal. The CLI supports persistent config (vai config set api-key) which will store the API key locally in the user's config; that is expected behavior for a CLI but users should be aware it persists credentials to disk. The skill does not request system-wide or other skills' settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install voyageai-skill
  3. After installation, invoke the skill by name or use /voyageai-skill
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.4.0
- Added comprehensive SKILL.md documentation detailing all features, setup instructions, environment variables, and command references. - Included usage examples for embeddings, reranking, vector search, model management, batch ingestion, and more. - Documented common workflows for typical vector search and retrieval use cases. - Listed global flags and linked reference guides for models and vector search patterns.
Metadata
Slug voyageai-skill
Version 1.4.0
License
All-time Installs 1
Active Installs 1
Total Versions 1
Frequently Asked Questions

What is Voyage AI CLI?

Voyage AI embedding and reranking CLI integrated with MongoDB Atlas Vector Search. Use for: generating text embeddings, reranking search results, storing embeddings in Atlas, performing vector similarity search, creating vector search indexes, listing available models, comparing text similarity, bulk ingestion, interactive demos, and learning about AI concepts. Triggers: embed text, generate embeddings, vector search, rerank documents, voyage ai, semantic search, similarity search, store embeddings, atlas vector search, embedding models, cosine similarity, bulk ingest, explain embeddings. It is an AI Agent Skill for Claude Code / OpenClaw, with 1856 downloads so far.

How do I install Voyage AI CLI?

Run "/install voyageai-skill" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Voyage AI CLI free?

Yes, Voyage AI CLI is completely free (open-source). You can download, install and use it at no cost.

Which platforms does Voyage AI CLI support?

Voyage AI CLI is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Voyage AI CLI?

It is built and maintained by Michael Lynn (@mrlynn); the current version is v1.4.0.

💬 Comments