# Vibeknow Core

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

- **Type:** Skill
- **Install:** `agentstack add skill-vibeknow-cli-vibeknow-core`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [vibeknow](https://agentstack.voostack.com/s/vibeknow)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [vibeknow](https://github.com/vibeknow)
- **Source:** https://github.com/vibeknow/cli/tree/main/skills/vibeknow-core
- **Website:** https://vibeknow.ai

## Install

```sh
agentstack add skill-vibeknow-cli-vibeknow-core
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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 `.
- **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](references/commands.md).

## Common Tasks

### Check if vibeknow is working

```bash
vibeknow doctor
vibeknow auth status
```

### Set up a new dev environment

```bash
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

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

### Diagnose auth failure

```bash
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](references/errors.md).

## Output Formats

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

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

## References

- [commands.md](references/commands.md) — Full flag reference for all 12 subcommands
- [errors.md](references/errors.md) — Exit codes, error codes, and Error Object schema

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [vibeknow](https://github.com/vibeknow)
- **Source:** [vibeknow/cli](https://github.com/vibeknow/cli)
- **License:** MIT
- **Homepage:** https://vibeknow.ai

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-vibeknow-cli-vibeknow-core
- Seller: https://agentstack.voostack.com/s/vibeknow
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.