VBase CLI Guide (Dodil CLI Plugin)

Last validated: 2026-05-11

This guide is now split by command domain. All examples use dodil with the vbase plugin.

Read by Domain

1. Quickstart, Auth, and Command Model
   • login flow, plugin invocation model, and first successful end-to-end session.
2. Database Commands
   • db create, db list, db use, db drop, db test-grpc with argument details.
3. Collection, Data, and Index Commands
   • schema creation modes, insert/search behavior, and index management.
4. Config, Context, Output, and Troubleshooting
   • config precedence, endpoint resolution, TLS behavior, and troubleshooting playbook.
5. CLI vs API Coverage Map
   • what is covered directly by CLI and what requires gRPC/HTTP fallback.
6. Metric and Index Selection Cheat Sheet
   • one-page quick chooser for similarity metric and index type decisions.

Minimal Quickstart

dodil login <service_account_id> <service_account_secret>
dodil vbase db create my-db
dodil vbase db list
dodil vbase db use <service_id>
dodil vbase status

For end-to-end practical scenarios that combine CLI and API fallback, see 06-workflows.md.