Vibeknow core

vibeknow CLI setup, authentication, profile management, and diagnostics. Use when: first-time setup, auth errors, switching environments, diagnosing connection issues.From its SKILL.md

Install

npx -y skills add vibeknow/cli --skill vibeknow-core

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

reads credentialsReads from 1 credential source: `VIBEKNOW_TOKEN`.
6 stars6 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
runs commandsInstructs the agent to run 7 commands, including `vibeknow doctor` and 6 more.

SKILL.md

4.4 KB, 839 tokens by cl100k_base, as published. Nobody here has run it

vibeknow-core

TRIGGER

First-time vibeknow setup or onboarding
Authentication errors or credential issues
Switching between environments (dev/staging/prod)
Diagnosing connection or endpoint problems
Managing profiles or config values

SKIP

Video generation, status, download → use vibeknow-create
Document upload or status → use vibeknow-doc

Core Concepts

Profile: A named environment config (endpoints + credential). Supports dev/staging/prod switching via vibeknow profile use <name>.
Credential priority: VIBEKNOW_TOKEN env var > OS keychain > encrypted file. The env var overrides everything and cannot be cleared by logout.
Endpoint trust boundary: Profiles pointing to localhost or non-official domains must set --trust dev --is-production=false, or the CLI refuses to start.
Doctor: Runs endpoint reachability checks and token validation. Use it first when anything seems wrong.

Quick Reference

Command	Description
`vibeknow auth status`	Show credential source and active profile
`vibeknow auth whoami`	Print current authenticated user
`vibeknow auth logout`	Clear stored credential for current profile
`vibeknow profile add NAME`	Add a new profile
`vibeknow profile use NAME`	Switch active profile
`vibeknow profile list`	List all profiles
`vibeknow profile show [NAME]`	Show profile details (default: current)
`vibeknow profile remove NAME`	Delete a profile
`vibeknow config get KEY`	Read a config value
`vibeknow config set KEY VALUE`	Write a config value
`vibeknow config list`	List all config keys
`vibeknow doctor`	Diagnose local setup and endpoint reachability

For full flags and output examples, see commands.md.

Common Tasks

Check if vibeknow is working

vibeknow doctor
vibeknow auth status

Set up a new dev environment

vibeknow profile add dev \
  --endpoint-figlens http://localhost:20067 \
  --trust dev \
  --is-production=false \
  --credential-ref vibeknow.dev
vibeknow profile use dev
vibeknow doctor

Switch between environments

vibeknow profile list              # see available profiles
vibeknow profile use prod          # switch to prod
vibeknow auth status               # verify credentials

Diagnose auth failure

vibeknow auth status               # check credential source
vibeknow auth whoami               # verify identity
vibeknow doctor                    # check endpoint reachability

Exit Code Handling

Exit	Meaning	Action
0	Success	—
1	General error	Check stderr message
2	Invalid arguments	Fix command syntax
3	Auth error	Run `vibeknow auth status`, check credential source
130	User interrupt (SIGINT)	—

For full exit code and error code reference, see errors.md.

Output Formats

All core commands support --output text|json|ndjson:

vibeknow auth status --output json    # structured output
vibeknow profile list --output json   # machine-readable profile list

References

commands.md — Full flag reference for all 12 subcommands
errors.md — Exit codes, error codes, and Error Object schema

What ships with it: 2 files

4.6 KB alongside SKILL.md

references/

commands.md3.2 KB
errors.md1.4 KB