open-index/open-npm huggingface dataset:
npm package: @messyvirgo/cli
Description: Messy Virgo public CLI
Latest version: 0.2.0

# Messy Virgo CLI

Public command-line interface for Messy Virgo fund, screening, macros, and activity workflows.

## Install

```bash
npx @messyvirgo/cli --help
```

## Auth and Config

The CLI talks to the API over HTTP and uses bearer auth.

- `MV_API_URL`: API base URL (for example `https://api.messyvirgo.com`)
- `MV_API_KEY`: API key (`mvk_...`)

You can also persist values in a profile:

```bash
mv config set api-url https://api.messyvirgo.com
mv config set api-key mvk_...
mv config get
```

Resolution order is: command flags -> environment -> profile config.

## JSON Output

Use `--json` for machine-readable output:

```bash
mv funds list --json
mv screening templates list --json
```

Errors in JSON mode use:

```json
{
  "error": {
    "code": "API_ERROR_CODE",
    "message": "Human readable message",
    "details": {},
    "status_code": 400
  }
}
```

## Command Groups

- `mv funds ...` - list funds and inspect fund status, performance, sleeves, and activity
- `mv screening ...` - execute screenings and work with screening runs, context, templates, KPIs, and scores
- `mv macros ...` - get current macro market context plus KPI and score definitions
- `mv config ...` - read or set persisted CLI config values

Use nested help to discover subtopics and commands:

```bash
mv screening --help
mv screening runs --help
mv macros kpis --help
```

## Local Development

```bash
cd services/cli
npm install
npm run build
npm test
```

## Runbook

- `docs/runbooks/command-line-interface.md`