@broomva/cli
CLI for broomva.tech — prompts, skills, and context from the terminal.
Installation
bunx @broomva/cli # one-shot
bun add -g @broomva/cli # global install
Authentication
broomva auth login # Guided login: sign in → get token → paste
broomva auth status # Check auth state
broomva auth token # Print current token
broomva auth logout # Remove stored token
How it works
- Sign in at broomva.tech using email/password, Google, or GitHub. Accounts with the same email are automatically linked — you can sign up with email and later log in with Google (or vice versa) and it resolves to the same user.
- Get your token at
https://broomva.tech/api/auth/api-token(requires active session). - Paste it when
broomva auth loginprompts you, or setBROOMVA_API_TOKENenv var.
Token is stored in ~/.broomva/config.json (0o600). Resolution order: --token flag > BROOMVA_API_TOKEN env > config file. Tokens are session-scoped and auto-expire.
Commands
Prompts
broomva prompts list # List all public prompts
broomva prompts list --mine # List your prompts (auth required)
broomva prompts list --category agents # Filter by category
broomva prompts list --tag research --json # JSON output
broomva prompts get <slug> # Show prompt with metadata
broomva prompts get <slug> --raw # Content only (pipe-friendly)
broomva prompts get <slug> --json # Full JSON
broomva prompts create --title "My Prompt" --content @prompt.md
broomva prompts update <slug> --content @updated.md --tags "agent,research"
broomva prompts delete <slug>
broomva prompts pull <slug> # Download to <slug>.md
broomva prompts pull <slug> -o custom.md # Custom output path
broomva prompts push prompt.md # Update from local file
broomva prompts push prompt.md --create # Create new from local file
Skills
broomva skills list # Browse all layers
broomva skills list --layer foundation # Filter by layer
broomva skills get <slug> # Skill details
broomva skills install <slug> # Runs npx skills add broomva/<slug>
Context
broomva context show # Full project context
broomva context conventions # Conventions only
broomva context stack # Tech stack only
Config
broomva config get # Show all config
broomva config get apiBase # Show single value
broomva config set apiBase http://localhost:3000 # Override API base
broomva config set defaultFormat json # Default output format
broomva config reset # Reset to defaults
Global Options
--json Output as JSON
--api-base URL Override API base URL
--token TOKEN Override auth token
--no-color Disable colored output
API Base
Default: https://broomva.tech. Override with --api-base, broomva config set apiBase, or for local dev: --api-base http://localhost:3000.
File Format for Push/Pull
Prompts use markdown with YAML frontmatter:
---
title: "My Prompt"
slug: "my-prompt"
category: "agents"
tags: ["research", "coding"]
visibility: "public"
---
Your prompt content here...