byterover-cli 0.1.1 → 0.2.0

package/README.md

@@ -6,6 +6,14 @@ Command-line interface for ByteRover, enabling seamless team/space management, a
 [![Downloads/week](https://img.shields.io/npm/dw/byterover-cli.svg)](https://npmjs.org/package/byterover-cli)
 [![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)](https://nodejs.org)
 
+## Important
+
+Starting with version **0.2.0**, the ByteRover CLI command has been renamed from `br` to `brv` to avoid conflicts with [broot](https://github.com/Canop/broot), another popular CLI tool that also uses the `br` command.
+
+This is a **breaking change** that requires action from existing users.
+
+Please check the migration guide [here](https://docs.byterover.dev/beta/migration-br-brv).
+
 ## Table of Contents
 
 * [Installation](#installation)
@@ -40,17 +48,19 @@ npm install -g byterover-cli
 ### Verify installation
 
 ```bash
-br --version
+brv --version
 ```
 
 ## Quick Start
 
+Visit [**ByteRover's Beta Docs**](https://docs.byterover.dev/beta) for more information.
+
 Get started with ByteRover CLI in three simple steps:
 
 ### 1. Authenticate
 
 ```bash
-br login
+brv login
 ```
 
 This opens your browser to complete OAuth authentication. Your credentials are securely stored in the system keychain.
@@ -58,8 +68,8 @@ This opens your browser to complete OAuth authentication. Your credentials are s
 ### 2. Initialize a project
 
 ```bash
-cd your-project-directory
-br init
+cd to/your/project
+brv init
 ```
 
 Select a space from your available spaces and configure your project.
@@ -100,14 +110,14 @@ If you're using a coding agent like Claude Code:
 
 ```bash
 # Complete ACE workflow in a single command
-br complete "auth-feature" \
+brv complete "auth-feature" \
   "Implemented JWT authentication with secure token handling" \
   "Successfully added OAuth2 authentication" \
   --tool-usage "Read:src/auth.ts,Edit:src/auth.ts,Bash:npm test" \
   --feedback "All tests passed, auth works correctly"
 ```
 
-For comprehensive ACE instructions for coding agents, check the corresponding coding agents' instruction files after `br init` or `br gen-rules`.
+For comprehensive ACE instructions for coding agents, check the corresponding coding agents' instruction files after `brv init` or `brv gen-rules`.
 
 ## Essential Commands
 
@@ -115,46 +125,46 @@ For comprehensive ACE instructions for coding agents, check the corresponding co
 
 ```bash
 # Log in to ByteRover
-br login
+brv login
 
 # Check your authentication and project status
-br status
+brv status
 ```
 
 ### Project Setup
 
 ```bash
 # Initialize project with ByteRover
-br init
+brv init
 
 # List available spaces
-br space list
+brv space list
 
 # Switch to a different space or team
-br space switch
+brv space switch
 ```
 
 ### Memory Operations
 
 ```bash
 # Retrieve memories from ByteRover (outputs to stdout for agent context)
-br retrieve --query "authentication best practices"
-br retrieve -q "error handling" -n "src/auth/login.ts,src/auth/oauth.ts"
+brv retrieve --query "authentication best practices"
+brv retrieve -q "error handling" -n "src/auth/login.ts,src/auth/oauth.ts"
 
 # Push your playbook to ByteRover's memory storage
-br push
+brv push
 ```
 
 ### For Coding Agents
 
 ```bash
 # Complete ACE workflow (recommended for agents)
-br complete <hint> <reasoning> <answer> \
+brv complete <hint> <reasoning> <answer> \
   --tool-usage <tools> \
   --feedback <feedback>
 
 # Generate agent rules (sets up ACE workflow for your coding agent)
-br gen-rules
+brv gen-rules
 ```
 
 ## Authentication
@@ -163,7 +173,7 @@ ByteRover CLI uses **OAuth 2.0 with PKCE** (Proof Key for Code Exchange) for sec
 
 ### How it works
 
-1. Run `br login` to start authentication
+1. Run `brv login` to start authentication
 2. Your browser opens to the ByteRover authorization page
 3. After successful login, tokens are securely stored in your system keychain
 4. All subsequent commands automatically use your stored credentials
@@ -179,7 +189,7 @@ ByteRover CLI uses **OAuth 2.0 with PKCE** (Proof Key for Code Exchange) for sec
 
 ### Project Configuration
 
-When you run `br init`, a configuration file is created at `.br/config.json` in your project directory containing:
+When you run `brv init`, a configuration file is created at `.brv/config.json` in your project directory containing:
 
 - **Space ID**: The ByteRover workspace/space associated with this project
 - **User information**: Your user ID and email
@@ -187,17 +197,17 @@ When you run `br init`, a configuration file is created at `.br/config.json` in
 
 ### ACE File Structure
 
-ACE stores all outputs in `.br/ace/`:
+ACE stores all outputs in `.brv/ace/`:
 
 ```
-.br/ace/
+.brv/ace/
 ├── playbook.json                # Your living knowledge base
 ├── executor-outputs/            # Coding task outputs
 ├── reflections/                 # Task analysis and feedback
 └── deltas/                      # Playbook updates
 ```
 
-**Note**: When you run `br push`, the playbook is uploaded to ByteRover's memory storage, and local ACE files are automatically cleaned up to keep your workspace organized.
+**Note**: When you run `brv push`, the playbook is uploaded to ByteRover's memory storage, and local ACE files are automatically cleaned up to keep your workspace organized.
 
 ## Getting Help
 
@@ -205,20 +215,20 @@ ACE stores all outputs in `.br/ace/`:
 
 ```bash
 # Get general help
-br help
+brv --help
 
 # Get help for a specific command
-br help login
-br help init
-br help push
+brv login --help
+brv init --help
+brv push --help
 ```
 
 ### Support
 
 If you encounter issues or have questions:
 
-1. Check the command help: `br help [command]`
-2. Review your status: `br status`
+1. Check the command help: `brv [command] --help`
+2. Review your status: `brv status`
 3. Contact ByteRover support
 
 ---

package/bin/dev.cmd

@@ -1,4 +1,4 @@
 @echo off
 
-set BR_ENV=development
+set BRV_ENV=development
 node --loader ts-node/esm --no-warnings=ExperimentalWarning "%~dp0\dev" %*

package/bin/dev.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env -S node --loader ts-node/esm --disable-warning=ExperimentalWarning
 
-process.env.BR_ENV = 'development'
+process.env.BRV_ENV = 'development'
 
 import {execute} from '@oclif/core'
 

package/bin/run.cmd

@@ -1,4 +1,4 @@
 @echo off
 
-set BR_ENV=production
+set BRV_ENV=production
 node "%~dp0\run" %*

package/bin/run.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 
-process.env.BR_ENV = 'production'
+process.env.BRV_ENV = 'production'
 
 import {execute} from '@oclif/core'
 

package/dist/commands/add.js

@@ -62,7 +62,7 @@ export default class Add extends Command {
         this.log(`  Section: ${section}`);
         const contentDisplay = content.length > 200 ? `${content.slice(0, 200)}...` : content;
         this.log(`  Content: ${contentDisplay}`);
-        this.log('\nTip: Use `br status` to view and update bullets later');
+        this.log('\nTip: Use `brv status` to view and update bullets later');
         const confirmed = await confirm({
             default: true,
             message: 'Add this bullet?',

package/dist/commands/init.js

@@ -1,7 +1,8 @@
 import { select } from '@inquirer/prompts';
 import { Command, ux } from '@oclif/core';
 import { getCurrentConfig } from '../config/environment.js';
-import { BrConfig } from '../core/domain/entities/br-config.js';
+import { BRV_DIR, PROJECT_CONFIG_FILE } from '../constants.js';
+import { BrvConfig } from '../core/domain/entities/brv-config.js';
 import { ProjectConfigStore } from '../infra/config/file-config-store.js';
 import { FilePlaybookService } from '../infra/playbook/file-playbook-service.js';
 import { HttpSpaceService } from '../infra/space/http-space-service.js';
@@ -9,7 +10,7 @@ import { KeychainTokenStore } from '../infra/storage/keychain-token-store.js';
 import { HttpTeamService } from '../infra/team/http-team-service.js';
 import { MixpanelTrackingService } from '../infra/tracking/mixpanel-tracking-service.js';
 export default class Init extends Command {
-    static description = 'Initialize a project with ByteRover (creates .br/config.json with team/space selection and initializes ACE playbook)';
+    static description = `Initialize a project with ByteRover (creates ${BRV_DIR}/${PROJECT_CONFIG_FILE} with team/space selection and initializes ACE playbook)`;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '# Re-initialize if config exists (will show current config and exit):\n<%= config.bin %> <%= command.id %>',
@@ -75,10 +76,10 @@ export default class Init extends Command {
             // 2. Load and validate authentication token
             const token = await tokenStore.load();
             if (token === undefined) {
-                this.error('Not authenticated. Please run "br login" first.');
+                this.error('Not authenticated. Please run "brv login" first.');
             }
             if (!token.isValid()) {
-                this.error('Authentication token expired. Please run "br login" again.');
+                this.error('Authentication token expired. Please run "brv login" again.');
             }
             // 3. Fetch all teams with spinner
             ux.action.start('Fetching all teams');
@@ -86,7 +87,9 @@ export default class Init extends Command {
             ux.action.stop();
             const { teams } = teamResult;
             if (teams.length === 0) {
-                this.error('No teams found. Please create a team in the ByteRover dashboard first.');
+                this.log('No teams found.');
+                this.log(`Please visit ${getCurrentConfig().webAppUrl} to create your first team.`);
+                return;
             }
             // 4. Prompt for team selection
             this.log();
@@ -99,13 +102,15 @@ export default class Init extends Command {
             ux.action.stop();
             const { spaces } = spaceResult;
             if (spaces.length === 0) {
-                this.error(`No spaces found in team "${selectedTeam.getDisplayName()}". Please create a space in the ByteRover dashboard first.`);
+                this.log(`No spaces found in team "${selectedTeam.getDisplayName()}"`);
+                this.log(`Please visit ${getCurrentConfig().webAppUrl} to create your first space for ${selectedTeam.getDisplayName()}.`);
+                return;
             }
             // 6. Prompt for space selection
             this.log();
             const selectedSpace = await this.promptForSpaceSelection(spaces);
             // 7. Create and save configuration
-            const config = BrConfig.fromSpace(selectedSpace);
+            const config = BrvConfig.fromSpace(selectedSpace);
             await projectConfigStore.write(config);
             // 8. Initialize ACE playbook
             this.log('\nInitializing ACE context...');
@@ -126,7 +131,7 @@ export default class Init extends Command {
             // 10. Display success
             this.log(`\n✓ Project initialized successfully!`);
             this.log(`✓ Connected to space: ${selectedSpace.getDisplayName()}`);
-            this.log(`✓ Configuration saved to: .br/config.json`);
+            this.log(`✓ Configuration saved to: ${BRV_DIR}/${PROJECT_CONFIG_FILE}`);
         }
         catch (error) {
             this.error(error instanceof Error ? error.message : 'Initialization failed');

package/dist/commands/push.d.ts

@@ -1,6 +1,6 @@
 import { Command } from '@oclif/core';
 import type { AuthToken } from '../core/domain/entities/auth-token.js';
-import type { BrConfig } from '../core/domain/entities/br-config.js';
+import type { BrvConfig } from '../core/domain/entities/brv-config.js';
 import type { PresignedUrl } from '../core/domain/entities/presigned-url.js';
 import type { PresignedUrlsResponse } from '../core/domain/entities/presigned-urls-response.js';
 import type { IMemoryStorageService } from '../core/interfaces/i-memory-storage-service.js';
@@ -15,10 +15,10 @@ export default class Push extends Command {
         branch: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         yes: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
-    protected checkProjectInit(projectConfigStore: IProjectConfigStore): Promise<BrConfig>;
+    protected checkProjectInit(projectConfigStore: IProjectConfigStore): Promise<BrvConfig>;
     protected cleanUpLocalFiles(playbookStore: IPlaybookStore): Promise<void>;
-    protected confirmPush(projectConfig: BrConfig, branch: string, fileCount: number): Promise<boolean>;
-    protected confirmUpload(memoryService: IMemoryStorageService, token: AuthToken, projectConfig: BrConfig, requestId: string): Promise<void>;
+    protected confirmPush(projectConfig: BrvConfig, branch: string, fileCount: number): Promise<boolean>;
+    protected confirmUpload(memoryService: IMemoryStorageService, token: AuthToken, projectConfig: BrvConfig, requestId: string): Promise<void>;
     protected createServices(): {
         memoryService: IMemoryStorageService;
         playbookStore: IPlaybookStore;
@@ -26,7 +26,7 @@ export default class Push extends Command {
         tokenStore: ITokenStore;
         trackingService: ITrackingService;
     };
-    protected getPresignedUrls(memoryService: IMemoryStorageService, token: AuthToken, projectConfig: BrConfig): Promise<PresignedUrlsResponse>;
+    protected getPresignedUrls(memoryService: IMemoryStorageService, token: AuthToken, projectConfig: BrvConfig): Promise<PresignedUrlsResponse>;
     protected loadPlaybookContent(playbookStore: IPlaybookStore): Promise<string>;
     run(): Promise<void>;
     protected uploadFiles(memoryService: IMemoryStorageService, presignedUrls: ReadonlyArray<PresignedUrl>, playbookContent: string): Promise<void>;

package/dist/commands/push.js

@@ -2,7 +2,7 @@ import { confirm } from '@inquirer/prompts';
 import { Command, Flags, ux } from '@oclif/core';
 import { join } from 'node:path';
 import { getCurrentConfig } from '../config/environment.js';
-import { ACE_DIR, BR_DIR, DEFAULT_BRANCH, DELTAS_DIR, EXECUTOR_OUTPUTS_DIR, REFLECTIONS_DIR } from '../constants.js';
+import { ACE_DIR, BRV_DIR, BULLETS_DIR, DEFAULT_BRANCH, DELTAS_DIR, EXECUTOR_OUTPUTS_DIR, PLAYBOOK_FILE, REFLECTIONS_DIR, } from '../constants.js';
 import { FilePlaybookStore } from '../infra/ace/file-playbook-store.js';
 import { ProjectConfigStore } from '../infra/config/file-config-store.js';
 import { HttpMemoryStorageService } from '../infra/memory/http-memory-storage-service.js';
@@ -32,7 +32,7 @@ export default class Push extends Command {
     async checkProjectInit(projectConfigStore) {
         const projectConfig = await projectConfigStore.read();
         if (projectConfig === undefined) {
-            this.error('Project not initialized. Run "br init" first.');
+            this.error('Project not initialized. Run "brv init" first.');
         }
         return projectConfig;
     }
@@ -44,7 +44,7 @@ export default class Push extends Command {
         ux.action.stop('✓');
         // Clean executor outputs
         const baseDir = process.cwd();
-        const aceDir = join(baseDir, BR_DIR, ACE_DIR);
+        const aceDir = join(baseDir, BRV_DIR, ACE_DIR);
         const executorOutputsDir = join(aceDir, EXECUTOR_OUTPUTS_DIR);
         const reflectionsDir = join(aceDir, REFLECTIONS_DIR);
         const deltasDir = join(aceDir, DELTAS_DIR);
@@ -67,10 +67,10 @@ export default class Push extends Command {
         this.log(`  Files to upload: ${fileCount}`);
         this.log('\nAfter successful push, these local files will be cleaned up:');
         this.log('  - Playbook content');
-        this.log('  - Bullet files (.br/ace/bullets/)');
-        this.log('  - Executor outputs (.br/ace/executor-outputs/)');
-        this.log('  - Reflections (.br/ace/reflections/)');
-        this.log('  - Deltas (.br/ace/deltas/)');
+        this.log(`  - Bullet files (${BRV_DIR}/${ACE_DIR}/${BULLETS_DIR}/)`);
+        this.log(`  - Executor outputs (${BRV_DIR}/${ACE_DIR}/${EXECUTOR_OUTPUTS_DIR}/)`);
+        this.log(`  - Reflections (${BRV_DIR}/${ACE_DIR}/${REFLECTIONS_DIR}/)`);
+        this.log(`  - Deltas (${BRV_DIR}/${ACE_DIR}/${DELTAS_DIR}/)`);
         return confirm({
             default: false,
             message: 'Push to ByteRover and clean up local files?',
@@ -107,7 +107,7 @@ export default class Push extends Command {
         const response = await memoryService.getPresignedUrls({
             accessToken: token.accessToken,
             branch: flags.branch,
-            fileNames: ['playbook.json'],
+            fileNames: [`${PLAYBOOK_FILE}`],
             sessionKey: token.sessionKey,
             spaceId: projectConfig.spaceId,
             teamId: projectConfig.teamId,
@@ -164,17 +164,17 @@ export default class Push extends Command {
     async validateAuth(tokenStore) {
         const token = await tokenStore.load();
         if (token === undefined) {
-            this.error('Not authenticated. Run "br login" first.');
+            this.error('Not authenticated. Run "brv login" first.');
         }
         if (!token.isValid()) {
-            this.error('Authentication token expired. Run "br login" again.');
+            this.error('Authentication token expired. Run "brv login" again.');
         }
         return token;
     }
     async verifyPlaybookExists(playbookStore) {
         const playbookExists = await playbookStore.exists();
         if (!playbookExists) {
-            this.error('Playbook not found. Run "br init" to create one.');
+            this.error('Playbook not found. Run "brv init" to create one.');
         }
     }
 }

package/dist/commands/retrieve.d.ts

@@ -1,6 +1,6 @@
 import { Command } from '@oclif/core';
 import type { AuthToken } from '../core/domain/entities/auth-token.js';
-import type { BrConfig } from '../core/domain/entities/br-config.js';
+import type { BrvConfig } from '../core/domain/entities/brv-config.js';
 import type { IMemoryRetrievalService } from '../core/interfaces/i-memory-retrieval-service.js';
 import type { IProjectConfigStore } from '../core/interfaces/i-project-config-store.js';
 import type { ITokenStore } from '../core/interfaces/i-token-store.js';
@@ -13,7 +13,7 @@ export default class Retrieve extends Command {
         'node-keys': import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         query: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
     };
-    protected checkProjectInt(projectConfigStore: IProjectConfigStore): Promise<BrConfig>;
+    protected checkProjectInt(projectConfigStore: IProjectConfigStore): Promise<BrvConfig>;
     protected createServices(): {
         memoryService: IMemoryRetrievalService;
         projectConfigStore: IProjectConfigStore;

package/dist/commands/retrieve.js

@@ -31,7 +31,7 @@ export default class Retrieve extends Command {
     async checkProjectInt(projectConfigStore) {
         const isInitialized = await projectConfigStore.exists();
         if (!isInitialized) {
-            this.error('Project is not initialized. Please run "br init" first.');
+            this.error('Project is not initialized. Please run "brv init" first.');
         }
         const config = await projectConfigStore.read();
         if (!config) {
@@ -82,10 +82,10 @@ export default class Retrieve extends Command {
     async validateAuth(tokenStore) {
         const token = await tokenStore.load();
         if (token === undefined) {
-            this.error('Not authenticated. Please run "br auth login" first.');
+            this.error('Not authenticated. Please run "brv login" first.');
         }
         if (!token.isValid()) {
-            this.error('Authentication token expired. Please run "br auth login" again.');
+            this.error('Authentication token expired. Please run "brv login" again.');
         }
         return token;
     }

package/dist/commands/space/list.js

@@ -51,13 +51,18 @@ export default class SpaceList extends Command {
             // Check project initialization
             const projectConfig = await projectConfigStore.read();
             if (projectConfig === undefined) {
-                this.error('Project not initialized. Run "br init" first.');
+                this.error('Project not initialized. Run "brv init" first.');
             }
             const token = await this.validateAuth(tokenStore);
             // Fetch spaces for the team from project config
             ux.action.start(`Fetching spaces for ${projectConfig.teamName}`);
-            const result = await spaceService.getSpaces(token.accessToken, token.sessionKey, projectConfig.teamId, flags.all ? { fetchAll: true } : { limit: flags.limit, offset: flags.offset });
-            ux.action.stop();
+            let result;
+            try {
+                result = await spaceService.getSpaces(token.accessToken, token.sessionKey, projectConfig.teamId, flags.all ? { fetchAll: true } : { limit: flags.limit, offset: flags.offset });
+            }
+            finally {
+                ux.action.stop();
+            }
             // Handle empty results
             if (result.spaces.length === 0) {
                 this.log(`No spaces found in team "${projectConfig.teamName}".`);
@@ -95,10 +100,10 @@ export default class SpaceList extends Command {
     async validateAuth(tokenStore) {
         const token = await tokenStore.load();
         if (token === undefined) {
-            this.error('Not authenticated. Please run "br login" first.');
+            this.error('Not authenticated. Please run "brv login" first.');
         }
         if (!token.isValid()) {
-            this.error('Authentication token expired. Please run "br login" again.');
+            this.error('Authentication token expired. Please run "brv login" again.');
         }
         return token;
     }

package/dist/commands/space/switch.js

@@ -1,13 +1,14 @@
 import { select } from '@inquirer/prompts';
 import { Command, ux } from '@oclif/core';
 import { getCurrentConfig } from '../../config/environment.js';
-import { BrConfig } from '../../core/domain/entities/br-config.js';
+import { BRV_DIR, PROJECT_CONFIG_FILE } from '../../constants.js';
+import { BrvConfig } from '../../core/domain/entities/brv-config.js';
 import { ProjectConfigStore } from '../../infra/config/file-config-store.js';
 import { HttpSpaceService } from '../../infra/space/http-space-service.js';
 import { KeychainTokenStore } from '../../infra/storage/keychain-token-store.js';
 import { HttpTeamService } from '../../infra/team/http-team-service.js';
 export default class SpaceSwitch extends Command {
-    static description = 'Switch to a different team or space (updates .br/config.json)';
+    static description = `Switch to a different team or space (updates ${BRV_DIR}/${PROJECT_CONFIG_FILE})`;
     static examples = [
         '<%= config.bin %> <%= command.id %>',
         '# Shows current configuration, then prompts for new team/space selection',
@@ -59,7 +60,7 @@ export default class SpaceSwitch extends Command {
             // Check project initialization (MUST exist for switch)
             const currentConfig = await projectConfigStore.read();
             if (currentConfig === undefined) {
-                this.error('Project not initialized. Run "br init" first.');
+                this.error('Project not initialized. Run "brv init" first.');
             }
             // Show current configuration
             this.log('Current configuration:');
@@ -69,10 +70,10 @@ export default class SpaceSwitch extends Command {
             // Validate authentication
             const token = await tokenStore.load();
             if (token === undefined) {
-                this.error('Not authenticated. Please run "br login" first.');
+                this.error('Not authenticated. Please run "brv login" first.');
             }
             if (!token.isValid()) {
-                this.error('Authentication token expired. Please run "br login" again.');
+                this.error('Authentication token expired. Please run "brv login" again.');
             }
             // Fetch all teams
             ux.action.start('Fetching all teams');
@@ -97,11 +98,11 @@ export default class SpaceSwitch extends Command {
             this.log();
             const selectedSpace = await this.promptForSpaceSelection(spaceResult.spaces);
             // Update configuration
-            const newConfig = BrConfig.fromSpace(selectedSpace);
+            const newConfig = BrvConfig.fromSpace(selectedSpace);
             await projectConfigStore.write(newConfig);
             // Display success
             this.log(`\n✓ Successfully switched to space: ${selectedSpace.getDisplayName()}`);
-            this.log(`✓ Configuration updated in: .br/config.json`);
+            this.log(`✓ Configuration updated in: ${BRV_DIR}/${PROJECT_CONFIG_FILE}`);
         }
         catch (error) {
             this.error(error instanceof Error ? error.message : 'Switch failed');

package/dist/commands/status.js

@@ -1,6 +1,6 @@
 import { Args, Command, Flags } from '@oclif/core';
 import chalk from 'chalk';
-import { ACE_DIR, BR_DIR, BULLETS_DIR } from '../constants.js';
+import { ACE_DIR, BRV_DIR, BULLETS_DIR } from '../constants.js';
 import { FilePlaybookStore } from '../infra/ace/file-playbook-store.js';
 import { ProjectConfigStore } from '../infra/config/file-config-store.js';
 import { KeychainTokenStore } from '../infra/storage/keychain-token-store.js';
@@ -80,7 +80,7 @@ export default class Status extends Command {
         try {
             const playbook = await playbookStore.load(args.directory);
             if (!playbook) {
-                this.error('Playbook not found. Run `br init` to initialize.');
+                this.error('Playbook not found. Run `brv init` to initialize.');
             }
             // Display based on format
             if (flags.format === 'json') {
@@ -90,7 +90,7 @@ export default class Status extends Command {
             const bullets = playbook.getBullets();
             const sections = playbook.getSections();
             if (bullets.length === 0) {
-                this.log('Playbook is empty. Use "br add" commands to add knowledge.');
+                this.log('Playbook is empty. Use "brv add" commands to add knowledge.');
                 return;
             }
             this.log(`\nMemory not pushed to cloud:`);
@@ -101,12 +101,12 @@ export default class Status extends Command {
                 this.log(`# ${section}`);
                 const sectionBullets = playbook.getBulletsInSection(section);
                 for (const bullet of sectionBullets) {
-                    const relativePath = `${BR_DIR}/${ACE_DIR}/${BULLETS_DIR}/${bullet.id}.md`;
+                    const relativePath = `${BRV_DIR}/${ACE_DIR}/${BULLETS_DIR}/${bullet.id}.md`;
                     // Display like git status: red path
                     this.log(`  ${chalk.red(relativePath)}`);
                 }
             }
-            this.log(`\nUse "br push" to push playbook to ByteRover memory storage.`);
+            this.log(`\nUse "brv push" to push playbook to ByteRover memory storage.`);
         }
         catch (error) {
             this.error(error instanceof Error ? error.message : 'Failed to load playbook statistics');

package/dist/config/environment.d.ts

@@ -4,8 +4,8 @@
 type Environment = 'development' | 'production';
 /**
  * Current environment - set at runtime by the launcher scripts.
- * - `./bin/dev.js` sets BR_ENV=development
- * - `./bin/run.js` sets BR_ENV=production
+ * - `./bin/dev.js` sets BRV_ENV=development
+ * - `./bin/run.js` sets BRV_ENV=production
  */
 export declare const ENVIRONMENT: Environment;
 /**
@@ -21,6 +21,7 @@ type EnvironmentConfig = {
     mixpanelToken: string;
     scopes: string[];
     tokenUrl: string;
+    webAppUrl: string;
 };
 /**
  * Configuration for each environment.

package/dist/config/environment.js

@@ -1,9 +1,9 @@
 /**
  * Current environment - set at runtime by the launcher scripts.
- * - `./bin/dev.js` sets BR_ENV=development
- * - `./bin/run.js` sets BR_ENV=production
+ * - `./bin/dev.js` sets BRV_ENV=development
+ * - `./bin/run.js` sets BRV_ENV=production
  */
-export const ENVIRONMENT = process.env.BR_ENV ?? 'development';
+export const ENVIRONMENT = process.env.BRV_ENV ?? 'development';
 /**
  * Configuration for each environment.
  * These values are bundled at build time.
@@ -19,6 +19,7 @@ export const ENV_CONFIG = {
         mixpanelToken: '258e1a2b3d44cc634ef28964771b1da0',
         scopes: ['read', 'write', 'debug'],
         tokenUrl: 'https://dev-beta-iam.byterover.dev/api/v1/oidc/token',
+        webAppUrl: 'https://dev-beta-app.byterover.dev/',
     },
     production: {
         apiBaseUrl: 'https://beta-iam.byterover.dev/api/v1',
@@ -30,6 +31,7 @@ export const ENV_CONFIG = {
         mixpanelToken: '4d1198b346d2d6ac75f2e77905cc65ac',
         scopes: ['read', 'write'],
         tokenUrl: 'https://beta-iam.byterover.dev/api/v1/oidc/token',
+        webAppUrl: 'https://beta-app.byterover.dev',
     },
 };
 /**

package/dist/constants.d.ts

@@ -1,11 +1,18 @@
-export declare const BR_DIR = ".br";
+export declare const BRV_DIR = ".brv";
+export declare const PROJECT_CONFIG_FILE = "config.json";
 export declare const ACE_DIR = "ace";
 export declare const EXECUTOR_OUTPUTS_DIR = "executor-outputs";
 export declare const REFLECTIONS_DIR = "reflections";
 export declare const DELTAS_DIR = "deltas";
 export declare const BULLETS_DIR = "bullets";
+export declare const PLAYBOOK_FILE = "playbook.json";
 /**
  * Default ByteRover branch name for memory storage.
  * This is ByteRover's internal branching mechanism, not Git branches.
  */
 export declare const DEFAULT_BRANCH = "main";
+/**
+ * ByteRover documentation URL.
+ * Used in CLI help output to direct users to online documentation.
+ */
+export declare const DOCS_URL = "https://docs.byterover.dev/beta";