@inovaprog/vrtex

CLI for Vortex — manage projects and tasks from anywhere, without opening the web app.

Installation

npm install -g @inovaprog/vrtex

This installs the vortex command. The npm package is named @inovaprog/vrtex; the installed command remains vortex.

Usage

vortex login              # opens a browser (Google or GitHub)
vortex login --headless   # email and password, without a browser (SSH/VPN)
vortex logout
vortex init               # links the project, starts the devcontainer, and runs local tests
vortex init --verbose     # also shows devcontainer build and test output
vortex init --skip-tests  # refreshes project metadata and local context only
vortex run DEV-1234       # previews focused local context for a Vortex task
vortex run DEV-1234 --json # includes machine-readable candidates and token estimate

Environment variables

| Variable | Purpose | |---|---| | VORTEX_API_URL | API base URL (default: production) | | VORTEX_GOOGLE_CLIENT_ID | Google OAuth App client ID for social sign-in | | VORTEX_GITHUB_CLIENT_ID | GitHub OAuth App client ID for social sign-in | | VORTEX_OAUTH_PORT | Local port for the social sign-in callback (default: 51763) | | VORTEX_CONFIG_DIR | Where to save local credentials (default: ~/.vortex) |

During the first vortex init in a repository, the CLI asks for a BYOK provider (DeepSeek, OpenAI, Anthropic, or Google) and key if the root .env does not contain VORTEX_PROVIDER and VORTEX_PROVIDER_KEY. These variables are saved in the project .env and are used only to discover test commands.

vortex init also creates .vortex/context.db, a local SQLite index of source symbols and direct call relationships for targeted future task context.

vortex run DEV-XXXX fetches a task from the Vortex project linked to the current repository and searches that local index. It is a read-only preview: it reports the eight best matching symbols, immediate relationships, and an approximate token count for the initial source-free mini-harness payload. It does not edit files or send repository source code to an AI provider.

Development

npm install
npm run dev -- login --headless   # runs directly from src/, without building
npm test
npm run build                     # generates dist/