Authentication

8Vast works without signing in. Search, linting, file operations, stack, and local workflows all work offline. Sign in when you need organization features: shared projects, issues, features, documents, and sync.

Sign in

8v auth login --org mycompany

Enter your email and password. 8Vast stores your session securely — access token in memory, refresh token in your OS keychain. Sessions refresh automatically.

Check status

8v auth status

Shows which organizations you're signed in to and session details.

Sign out

8v auth logout --org mycompany

Signs out of one organization. To sign out of everything:

8v auth logout

What signing in unlocks

Without auth	With auth
File operations, git, search	+ Issues, features, documents
Local workflows	+ Shared workflows
Local linting	+ Team rules
Stack	+ Remote environments
CLI + desktop	+ Sync across devices

Everything on the left works without an account. The right column is what you gain by signing in.

Multiple organizations

You can sign in to multiple organizations at the same time. Each has its own session and its own set of projects. Use 8v auth status to see all active sessions.

When you run commands inside a project that's linked to an organization, 8Vast uses the correct session automatically. No switching required.

Linking projects

After signing in, link a local project to your organization:

8v project link

This enables sync: your project's issues, features, and documents become available to your team. See CLI Reference for all project commands.