byterover-cli 2.1.4 → 2.2.0

package/dist/oclif/commands/locations.d.ts

@@ -0,0 +1,14 @@
+import { Command } from '@oclif/core';
+import type { ProjectLocationDTO } from '../../shared/transport/types/dto.js';
+import { type DaemonClientOptions } from '../lib/daemon-client.js';
+export default class Locations extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected fetchLocations(options?: DaemonClientOptions): Promise<ProjectLocationDTO[]>;
+    run(): Promise<void>;
+    private formatLocationEntry;
+    private formatTextOutput;
+}

package/dist/oclif/commands/locations.js

@@ -0,0 +1,68 @@
+import { Command, Flags } from '@oclif/core';
+import chalk from 'chalk';
+import { LocationsEvents } from '../../shared/transport/events/locations-events.js';
+import { formatConnectionError, withDaemonRetry } from '../lib/daemon-client.js';
+import { writeJsonResponse } from '../lib/json-response.js';
+export default class Locations extends Command {
+    static description = 'List all registered projects and their context tree status';
+    static examples = ['<%= config.bin %> <%= command.id %>', '<%= config.bin %> <%= command.id %> --format json'];
+    static flags = {
+        format: Flags.string({
+            char: 'f',
+            default: 'text',
+            description: 'Output format',
+            options: ['text', 'json'],
+        }),
+    };
+    async fetchLocations(options) {
+        return withDaemonRetry(async (client) => {
+            const response = await client.requestWithAck(LocationsEvents.GET);
+            return response.locations;
+        }, options);
+    }
+    async run() {
+        const { flags } = await this.parse(Locations);
+        const isJson = flags.format === 'json';
+        try {
+            const locations = await this.fetchLocations();
+            if (isJson) {
+                writeJsonResponse({ command: 'locations', data: { locations }, success: true });
+            }
+            else {
+                this.formatTextOutput(locations);
+            }
+        }
+        catch (error) {
+            if (isJson) {
+                writeJsonResponse({ command: 'locations', data: { error: formatConnectionError(error) }, success: false });
+            }
+            else {
+                this.log(formatConnectionError(error));
+            }
+        }
+    }
+    formatLocationEntry(loc) {
+        const label = loc.isCurrent ? '  ' + chalk.green('[current]') : loc.isActive ? '  ' + chalk.yellow('[active]') : '';
+        const path = loc.isCurrent || loc.isActive ? chalk.bold(loc.projectPath) : loc.projectPath;
+        this.log(`  ${path}${label}`);
+        if (loc.isInitialized) {
+            this.log(chalk.dim('  └─ .brv/context-tree/'));
+        }
+        else {
+            this.log(chalk.dim('  └─ .brv/context-tree/    (not initialized)'));
+        }
+    }
+    formatTextOutput(locations) {
+        if (locations.length > 0) {
+            this.log(`Registered Projects — ${locations.length} found`);
+            this.log(chalk.dim('──────────────────────────────────────────'));
+            for (const loc of locations) {
+                this.formatLocationEntry(loc);
+                this.log('');
+            }
+        }
+        else {
+            this.log('Registered Projects — none found');
+        }
+    }
+}

package/dist/oclif/commands/logout.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+import { type AuthLogoutResponse } from '../../shared/transport/events/auth-events.js';
+import { type DaemonClientOptions } from '../lib/daemon-client.js';
+export default class Logout extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        format: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    protected performLogout(options?: DaemonClientOptions): Promise<AuthLogoutResponse>;
+    run(): Promise<void>;
+}

package/dist/oclif/commands/logout.js

@@ -0,0 +1,59 @@
+import { Command, Flags } from '@oclif/core';
+import { AuthEvents } from '../../shared/transport/events/auth-events.js';
+import { formatConnectionError, withDaemonRetry } from '../lib/daemon-client.js';
+import { writeJsonResponse } from '../lib/json-response.js';
+export default class Logout extends Command {
+    static description = 'Disconnect from ByteRover cloud and clear stored credentials';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '',
+        '# JSON output (for automation)',
+        '<%= config.bin %> <%= command.id %> --format json',
+    ];
+    static flags = {
+        format: Flags.string({
+            default: 'text',
+            description: 'Output format (text or json)',
+            options: ['text', 'json'],
+        }),
+    };
+    async performLogout(options) {
+        return withDaemonRetry(async (client) => client.requestWithAck(AuthEvents.LOGOUT), options);
+    }
+    async run() {
+        const { flags } = await this.parse(Logout);
+        const format = flags.format ?? 'text';
+        try {
+            if (format === 'text') {
+                this.log('Logging out...');
+            }
+            const response = await this.performLogout();
+            if (response.success) {
+                if (format === 'json') {
+                    writeJsonResponse({ command: 'logout', data: {}, success: true });
+                }
+                else {
+                    this.log('Logged out successfully');
+                }
+            }
+            else {
+                const errorMessage = response.error ?? 'Logout failed';
+                if (format === 'json') {
+                    writeJsonResponse({ command: 'logout', data: { error: errorMessage }, success: false });
+                }
+                else {
+                    this.log(errorMessage);
+                }
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Logout failed';
+            if (format === 'json') {
+                writeJsonResponse({ command: 'logout', data: { error: errorMessage }, success: false });
+            }
+            else {
+                this.log(formatConnectionError(error));
+            }
+        }
+    }
+}

package/dist/oclif/commands/status.js

@@ -22,10 +22,10 @@ export default class Status extends Command {
     }
     async run() {
         const { flags } = await this.parse(Status);
-        const format = flags.format;
+        const isJson = flags.format === 'json';
         try {
             const status = await this.fetchStatus();
-            if (format === 'json') {
+            if (isJson) {
                 writeJsonResponse({
                     command: 'status',
                     data: { ...status, cliVersion: this.config.version },
@@ -37,7 +37,7 @@ export default class Status extends Command {
             }
         }
         catch (error) {
-            if (format === 'json') {
+            if (isJson) {
                 writeJsonResponse({
                     command: 'status',
                     data: { error: formatConnectionError(error) },

package/dist/server/infra/daemon/brv-server.js

@@ -352,7 +352,9 @@ async function main() {
             broadcastToProject(projectPath, event, data) {
                 broadcastToProjectRoom(projectRegistry, projectRouter, projectPath, event, data);
             },
+            getActiveProjectPaths: () => clientManager.getActiveProjects(),
             log,
+            projectRegistry,
             providerConfigStore,
             providerKeychainStore,
             resolveProjectPath: (clientId) => clientManager.getClient(clientId)?.projectPath,

package/dist/server/infra/process/feature-handlers.d.ts

@@ -6,13 +6,16 @@
  */
 import type { IProviderConfigStore } from '../../core/interfaces/i-provider-config-store.js';
 import type { IProviderKeychainStore } from '../../core/interfaces/i-provider-keychain-store.js';
+import type { IProjectRegistry } from '../../core/interfaces/project/i-project-registry.js';
 import type { IAuthStateStore } from '../../core/interfaces/state/i-auth-state-store.js';
 import type { ITransportServer } from '../../core/interfaces/transport/i-transport-server.js';
 import type { ProjectBroadcaster, ProjectPathResolver } from '../transport/handlers/handler-types.js';
 export interface FeatureHandlersOptions {
     authStateStore: IAuthStateStore;
     broadcastToProject: ProjectBroadcaster;
+    getActiveProjectPaths: () => string[];
     log: (msg: string) => void;
+    projectRegistry: IProjectRegistry;
     providerConfigStore: IProviderConfigStore;
     providerKeychainStore: IProviderKeychainStore;
     resolveProjectPath: ProjectPathResolver;
@@ -22,4 +25,4 @@ export interface FeatureHandlersOptions {
  * Setup all feature handlers on the transport server.
  * These handlers implement the TUI ↔ Server event contract (auth:*, config:*, status:*, etc.).
  */
-export declare function setupFeatureHandlers({ authStateStore, broadcastToProject, log, providerConfigStore, providerKeychainStore, resolveProjectPath, transport, }: FeatureHandlersOptions): Promise<void>;
+export declare function setupFeatureHandlers({ authStateStore, broadcastToProject, getActiveProjectPaths, log, projectRegistry, providerConfigStore, providerKeychainStore, resolveProjectPath, transport, }: FeatureHandlersOptions): Promise<void>;

package/dist/server/infra/process/feature-handlers.js

@@ -29,13 +29,13 @@ import { HttpSpaceService } from '../space/http-space-service.js';
 import { createTokenStore } from '../storage/token-store.js';
 import { HttpTeamService } from '../team/http-team-service.js';
 import { FsTemplateLoader } from '../template/fs-template-loader.js';
-import { AuthHandler, ConfigHandler, ConnectorsHandler, HubHandler, InitHandler, ModelHandler, ProviderHandler, PullHandler, PushHandler, ResetHandler, SpaceHandler, StatusHandler, } from '../transport/handlers/index.js';
+import { AuthHandler, ConfigHandler, ConnectorsHandler, HubHandler, InitHandler, LocationsHandler, ModelHandler, ProviderHandler, PullHandler, PushHandler, ResetHandler, SpaceHandler, StatusHandler, } from '../transport/handlers/index.js';
 import { HttpUserService } from '../user/http-user-service.js';
 /**
  * Setup all feature handlers on the transport server.
  * These handlers implement the TUI ↔ Server event contract (auth:*, config:*, status:*, etc.).
  */
-export async function setupFeatureHandlers({ authStateStore, broadcastToProject, log, providerConfigStore, providerKeychainStore, resolveProjectPath, transport, }) {
+export async function setupFeatureHandlers({ authStateStore, broadcastToProject, getActiveProjectPaths, log, projectRegistry, providerConfigStore, providerKeychainStore, resolveProjectPath, transport, }) {
     const envConfig = getCurrentConfig();
     const tokenStore = createTokenStore();
     const projectConfigStore = new ProjectConfigStore();
@@ -90,6 +90,13 @@ export async function setupFeatureHandlers({ authStateStore, broadcastToProject,
         tokenStore,
         transport,
     }).setup();
+    new LocationsHandler({
+        contextTreeService,
+        getActiveProjectPaths,
+        projectRegistry,
+        resolveProjectPath,
+        transport,
+    }).setup();
     new PushHandler({
         broadcastToProject,
         cogitPushService,

package/dist/server/infra/transport/handlers/index.d.ts

@@ -10,6 +10,8 @@ export { HubHandler } from './hub-handler.js';
 export type { HubHandlerDeps } from './hub-handler.js';
 export { InitHandler } from './init-handler.js';
 export type { InitHandlerDeps } from './init-handler.js';
+export { LocationsHandler } from './locations-handler.js';
+export type { LocationsHandlerDeps } from './locations-handler.js';
 export { ModelHandler } from './model-handler.js';
 export type { ModelHandlerDeps } from './model-handler.js';
 export { ProviderHandler } from './provider-handler.js';

package/dist/server/infra/transport/handlers/index.js

@@ -4,6 +4,7 @@ export { ConnectorsHandler } from './connectors-handler.js';
 export { resolveRequiredProjectPath } from './handler-types.js';
 export { HubHandler } from './hub-handler.js';
 export { InitHandler } from './init-handler.js';
+export { LocationsHandler } from './locations-handler.js';
 export { ModelHandler } from './model-handler.js';
 export { ProviderHandler } from './provider-handler.js';
 export { PullHandler } from './pull-handler.js';

package/dist/server/infra/transport/handlers/locations-handler.d.ts

@@ -0,0 +1,25 @@
+import type { IContextTreeService } from '../../../core/interfaces/context-tree/i-context-tree-service.js';
+import type { IProjectRegistry } from '../../../core/interfaces/project/i-project-registry.js';
+import type { ITransportServer } from '../../../core/interfaces/transport/i-transport-server.js';
+import { type ProjectPathResolver } from './handler-types.js';
+export interface LocationsHandlerDeps {
+    contextTreeService: IContextTreeService;
+    getActiveProjectPaths: () => string[];
+    projectRegistry: IProjectRegistry;
+    resolveProjectPath: ProjectPathResolver;
+    transport: ITransportServer;
+}
+/**
+ * Handles locations:get event.
+ * Returns all registered project locations with context tree status.
+ */
+export declare class LocationsHandler {
+    private readonly contextTreeService;
+    private readonly getActiveProjectPaths;
+    private readonly projectRegistry;
+    private readonly resolveProjectPath;
+    private readonly transport;
+    constructor(deps: LocationsHandlerDeps);
+    setup(): void;
+    private buildLocations;
+}

package/dist/server/infra/transport/handlers/locations-handler.js

@@ -0,0 +1,64 @@
+import { join } from 'node:path';
+import { LocationsEvents } from '../../../../shared/transport/events/locations-events.js';
+import { BRV_DIR, CONTEXT_TREE_DIR } from '../../../constants.js';
+import { resolveRequiredProjectPath } from './handler-types.js';
+/**
+ * Handles locations:get event.
+ * Returns all registered project locations with context tree status.
+ */
+export class LocationsHandler {
+    contextTreeService;
+    getActiveProjectPaths;
+    projectRegistry;
+    resolveProjectPath;
+    transport;
+    constructor(deps) {
+        this.contextTreeService = deps.contextTreeService;
+        this.getActiveProjectPaths = deps.getActiveProjectPaths;
+        this.projectRegistry = deps.projectRegistry;
+        this.resolveProjectPath = deps.resolveProjectPath;
+        this.transport = deps.transport;
+    }
+    setup() {
+        this.transport.onRequest(LocationsEvents.GET, async (_data, clientId) => {
+            const projectPath = resolveRequiredProjectPath(this.resolveProjectPath, clientId);
+            try {
+                const locations = await this.buildLocations(projectPath);
+                return { locations };
+            }
+            catch {
+                return { locations: [] };
+            }
+        });
+    }
+    async buildLocations(currentProjectPath) {
+        const all = this.projectRegistry.getAll();
+        const activeSet = new Set(this.getActiveProjectPaths());
+        const results = await Promise.all([...all.entries()].map(async ([path]) => {
+            let isInitialized = false;
+            try {
+                isInitialized = await this.contextTreeService.exists(path);
+            }
+            catch {
+                // FS error — treat as not initialized
+            }
+            return {
+                contextTreePath: join(path, BRV_DIR, CONTEXT_TREE_DIR),
+                isActive: activeSet.has(path) || path === currentProjectPath,
+                isCurrent: path === currentProjectPath,
+                isInitialized,
+                projectPath: path,
+            };
+        }));
+        // Sort: current first → active (has clients) → initialized → rest, all by registeredAt desc
+        return results.sort((a, b) => {
+            if (a.isCurrent !== b.isCurrent)
+                return a.isCurrent ? -1 : 1;
+            if (a.isActive !== b.isActive)
+                return a.isActive ? -1 : 1;
+            if (a.isInitialized !== b.isInitialized)
+                return a.isInitialized ? -1 : 1;
+            return (all.get(b.projectPath)?.registeredAt ?? 0) - (all.get(a.projectPath)?.registeredAt ?? 0);
+        });
+    }
+}

package/dist/server/templates/skill/SKILL.md

@@ -93,7 +93,25 @@ brv providers list
 brv providers connect openai --api-key sk-xxx --model gpt-4.1
 ```
 
-### 4. Cloud Sync (Optional)
+### 4. Project Locations
+**Overview:** List registered projects and their context tree paths. Returns project metadata including initialization status and active state. Use `-f json` for machine-readable output.
+
+**Use this when:**
+- You need to find a project's context tree path
+- You need to check which projects are registered
+- You need to verify if a project is initialized
+
+**Do NOT use this when:**
+- You already know the project path from your current context
+- You need project content rather than metadata — use `brv query` instead
+
+```bash
+brv locations -f json
+```
+
+JSON fields: `projectPath`, `contextTreePath`, `isCurrent`, `isActive`, `isInitialized`.
+
+### 5. Cloud Sync (Optional)
 **Overview:** Sync your local knowledge with a team via ByteRover's cloud service. Requires ByteRover authentication.
 
 **Setup steps:**

package/dist/shared/transport/events/auth-events.d.ts

@@ -33,6 +33,7 @@ export interface AuthLoginWithApiKeyResponse {
     userEmail?: string;
 }
 export interface AuthLogoutResponse {
+    error?: string;
     success: boolean;
 }
 export interface AuthRefreshResponse {

package/dist/shared/transport/events/index.d.ts

@@ -6,6 +6,7 @@ export * from './connector-events.js';
 export * from './hub-events.js';
 export * from './init-events.js';
 export * from './llm-events.js';
+export * from './locations-events.js';
 export * from './model-events.js';
 export * from './onboarding-events.js';
 export * from './provider-events.js';
@@ -103,6 +104,8 @@ export declare const AllEventGroups: readonly [{
     readonly EXECUTE: "reset:execute";
 }, {
     readonly SWITCHED: "session:switched";
+}, {
+    readonly GET: "locations:get";
 }, {
     readonly LIST: "space:list";
     readonly SWITCH: "space:switch";

package/dist/shared/transport/events/index.js

@@ -8,6 +8,7 @@ export * from './connector-events.js';
 export * from './hub-events.js';
 export * from './init-events.js';
 export * from './llm-events.js';
+export * from './locations-events.js';
 export * from './model-events.js';
 export * from './onboarding-events.js';
 export * from './provider-events.js';
@@ -26,6 +27,7 @@ import { ConnectorEvents } from './connector-events.js';
 import { HubEvents } from './hub-events.js';
 import { InitEvents } from './init-events.js';
 import { LlmEvents } from './llm-events.js';
+import { LocationsEvents } from './locations-events.js';
 import { ModelEvents } from './model-events.js';
 import { OnboardingEvents } from './onboarding-events.js';
 import { ProviderEvents } from './provider-events.js';
@@ -55,6 +57,7 @@ export const AllEventGroups = [
     PushEvents,
     ResetEvents,
     SessionEvents,
+    LocationsEvents,
     SpaceEvents,
     StatusEvents,
     TaskEvents,

package/dist/shared/transport/events/locations-events.d.ts

@@ -0,0 +1,7 @@
+import type { ProjectLocationDTO } from '../types/dto.js';
+export declare const LocationsEvents: {
+    readonly GET: "locations:get";
+};
+export interface LocationsGetResponse {
+    locations: ProjectLocationDTO[];
+}

package/dist/shared/transport/events/locations-events.js

@@ -0,0 +1,3 @@
+export const LocationsEvents = {
+    GET: 'locations:get',
+};

package/dist/shared/transport/types/dto.d.ts

@@ -97,6 +97,17 @@ export interface HubEntryDTO {
     type: 'agent-skill' | 'bundle';
     version: string;
 }
+export interface ProjectLocationDTO {
+    /** Absolute path to the context tree directory (e.g., '/Users/foo/project/.brv/context-tree') */
+    contextTreePath: string;
+    /** True if this project has connected clients/agents or is the current project */
+    isActive: boolean;
+    /** True if this is the project the client is currently running from */
+    isCurrent: boolean;
+    /** True if .brv/context-tree exists */
+    isInitialized: boolean;
+    projectPath: string;
+}
 export interface StatusDTO {
     authStatus: 'expired' | 'logged_in' | 'not_logged_in' | 'unknown';
     contextTreeChanges?: ContextTreeChanges;

package/dist/tui/features/commands/definitions/index.js

@@ -2,6 +2,7 @@ import { connectorsCommand } from './connectors.js';
 import { curateCommand } from './curate.js';
 import { exitCommand } from './exit.js';
 import { hubCommand } from './hub.js';
+import { locationsCommand } from './locations.js';
 import { loginCommand } from './login.js';
 import { logoutCommand } from './logout.js';
 import { modelCommand } from './model.js';
@@ -22,6 +23,7 @@ import { statusCommand } from './status.js';
 export const load = () => [
     // Core workflow - most frequently used
     statusCommand,
+    locationsCommand,
     curateCommand,
     queryCommand,
     // Connectors management

package/dist/tui/features/commands/definitions/locations.d.ts

@@ -0,0 +1,2 @@
+import type { SlashCommand } from '../../../types/commands.js';
+export declare const locationsCommand: SlashCommand;

package/dist/tui/features/commands/definitions/locations.js

@@ -0,0 +1,11 @@
+import React from 'react';
+import { LocationsView } from '../../locations/components/locations-view.js';
+export const locationsCommand = {
+    action() {
+        return {
+            render: ({ onCancel, onComplete }) => React.createElement(LocationsView, { onCancel, onComplete }),
+        };
+    },
+    description: 'List all registered projects and their context tree status',
+    name: 'locations',
+};

package/dist/tui/features/locations/api/get-locations.d.ts

@@ -0,0 +1,16 @@
+import type { QueryConfig } from '../../../lib/react-query.js';
+import { type LocationsGetResponse } from '../../../../shared/transport/events/index.js';
+export declare const getLocations: () => Promise<LocationsGetResponse>;
+export declare const getLocationsQueryOptions: () => import("@tanstack/react-query").OmitKeyof<import("@tanstack/react-query").UseQueryOptions<LocationsGetResponse, Error, LocationsGetResponse, string[]>, "queryFn"> & {
+    queryFn?: import("@tanstack/react-query").QueryFunction<LocationsGetResponse, string[], never> | undefined;
+} & {
+    queryKey: string[] & {
+        [dataTagSymbol]: LocationsGetResponse;
+        [dataTagErrorSymbol]: Error;
+    };
+};
+type UseGetLocationsOptions = {
+    queryConfig?: QueryConfig<typeof getLocationsQueryOptions>;
+};
+export declare const useGetLocations: ({ queryConfig }?: UseGetLocationsOptions) => import("@tanstack/react-query").UseQueryResult<LocationsGetResponse, Error>;
+export {};

package/dist/tui/features/locations/api/get-locations.js

@@ -0,0 +1,17 @@
+import { queryOptions, useQuery } from '@tanstack/react-query';
+import { LocationsEvents } from '../../../../shared/transport/events/index.js';
+import { useTransportStore } from '../../../stores/transport-store.js';
+export const getLocations = () => {
+    const { apiClient } = useTransportStore.getState();
+    if (!apiClient)
+        return Promise.reject(new Error('Not connected'));
+    return apiClient.request(LocationsEvents.GET);
+};
+export const getLocationsQueryOptions = () => queryOptions({
+    queryFn: getLocations,
+    queryKey: ['locations'],
+});
+export const useGetLocations = ({ queryConfig } = {}) => useQuery({
+    ...getLocationsQueryOptions(),
+    ...queryConfig,
+});

package/dist/tui/features/locations/components/locations-view.d.ts

@@ -0,0 +1,3 @@
+import React from 'react';
+import type { CustomDialogCallbacks } from '../../../types/commands.js';
+export declare function LocationsView({ onCancel, onComplete }: CustomDialogCallbacks): React.ReactNode;

package/dist/tui/features/locations/components/locations-view.js

@@ -0,0 +1,25 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Text, useInput } from 'ink';
+import Spinner from 'ink-spinner';
+import { useEffect } from 'react';
+import { useGetLocations } from '../api/get-locations.js';
+import { formatLocations } from '../utils/format-locations.js';
+export function LocationsView({ onCancel, onComplete }) {
+    const { data, error, isLoading } = useGetLocations();
+    useInput((_input, key) => {
+        if (key.escape)
+            onCancel();
+    });
+    useEffect(() => {
+        if (data) {
+            onComplete(formatLocations(data.locations));
+        }
+        if (error) {
+            onComplete(`Failed to get locations: ${error.message}`);
+        }
+    }, [data, error, onComplete]);
+    if (isLoading) {
+        return (_jsxs(Text, { children: [_jsx(Spinner, { type: "dots" }), " Loading locations..."] }));
+    }
+    return null;
+}

package/dist/tui/features/locations/utils/format-locations.d.ts

@@ -0,0 +1,2 @@
+import type { ProjectLocationDTO } from '../../../../shared/transport/types/dto.js';
+export declare function formatLocations(locations: ProjectLocationDTO[]): string;

package/dist/tui/features/locations/utils/format-locations.js

@@ -0,0 +1,26 @@
+import chalk from 'chalk';
+function formatLocationEntry(loc) {
+    const label = loc.isCurrent ? '  ' + chalk.green('[current]') : loc.isActive ? '  ' + chalk.yellow('[active]') : '';
+    const path = loc.isCurrent || loc.isActive ? chalk.bold(loc.projectPath) : loc.projectPath;
+    const lines = [`  ${path}${label}`];
+    if (loc.isInitialized) {
+        lines.push(chalk.dim('  └─ .brv/context-tree/'));
+    }
+    else {
+        lines.push(chalk.dim('  └─ .brv/context-tree/    (not initialized)'));
+    }
+    return lines;
+}
+export function formatLocations(locations) {
+    const lines = [];
+    if (locations.length > 0) {
+        lines.push(`Registered Projects — ${locations.length} found`, chalk.dim('──────────────────────────────────────────'));
+        for (const loc of locations) {
+            lines.push(...formatLocationEntry(loc), '');
+        }
+    }
+    else {
+        lines.push('Registered Projects — none found');
+    }
+    return lines.join('\n');
+}

package/oclif.manifest.json

@@ -75,6 +75,45 @@
         "hook-prompt-submit.js"
       ]
     },
+    "locations": {
+      "aliases": [],
+      "args": {},
+      "description": "List all registered projects and their context tree status",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --format json"
+      ],
+      "flags": {
+        "format": {
+          "char": "f",
+          "description": "Output format",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "locations",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "locations.js"
+      ]
+    },
     "login": {
       "aliases": [],
       "args": {},
@@ -124,6 +163,46 @@
         "login.js"
       ]
     },
+    "logout": {
+      "aliases": [],
+      "args": {},
+      "description": "Disconnect from ByteRover cloud and clear stored credentials",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "",
+        "# JSON output (for automation)",
+        "<%= config.bin %> <%= command.id %> --format json"
+      ],
+      "flags": {
+        "format": {
+          "description": "Output format (text or json)",
+          "name": "format",
+          "default": "text",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "text",
+            "json"
+          ],
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "logout",
+      "pluginAlias": "byterover-cli",
+      "pluginName": "byterover-cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "oclif",
+        "commands",
+        "logout.js"
+      ]
+    },
     "main": {
       "aliases": [],
       "args": {},
@@ -857,15 +936,40 @@
         "list.js"
       ]
     },
-    "model": {
+    "providers:connect": {
       "aliases": [],
-      "args": {},
-      "description": "Show the active model",
+      "args": {
+        "provider": {
+          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter)",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Connect or switch to an LLM provider",
       "examples": [
-        "<%= config.bin %> model",
-        "<%= config.bin %> model --format json"
+        "<%= config.bin %> providers connect anthropic --api-key sk-xxx",
+        "<%= config.bin %> providers connect openai --api-key sk-xxx --model gpt-4.1",
+        "<%= config.bin %> providers connect byterover",
+        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1",
+        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx --model llama3"
       ],
       "flags": {
+        "api-key": {
+          "char": "k",
+          "description": "API key for the provider",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "base-url": {
+          "char": "b",
+          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
+          "name": "base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -877,11 +981,19 @@
             "json"
           ],
           "type": "option"
+        },
+        "model": {
+          "char": "m",
+          "description": "Model to set as active after connecting",
+          "name": "model",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "model",
+      "id": "providers:connect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -892,17 +1004,23 @@
         "dist",
         "oclif",
         "commands",
-        "model",
-        "index.js"
+        "providers",
+        "connect.js"
       ]
     },
-    "model:list": {
+    "providers:disconnect": {
       "aliases": [],
-      "args": {},
-      "description": "List available models from all connected providers",
+      "args": {
+        "provider": {
+          "description": "Provider ID to disconnect",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Disconnect an LLM provider",
       "examples": [
-        "<%= config.bin %> model list",
-        "<%= config.bin %> model list --format json"
+        "<%= config.bin %> providers disconnect anthropic",
+        "<%= config.bin %> providers disconnect openai --format json"
       ],
       "flags": {
         "format": {
@@ -916,19 +1034,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "provider": {
-          "char": "p",
-          "description": "Only list models for a specific provider",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "model:list",
+      "id": "providers:disconnect",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -939,24 +1049,17 @@
         "dist",
         "oclif",
         "commands",
-        "model",
-        "list.js"
+        "providers",
+        "disconnect.js"
       ]
     },
-    "model:switch": {
+    "providers": {
       "aliases": [],
-      "args": {
-        "model": {
-          "description": "Model ID to switch to (e.g., claude-sonnet-4-5, gpt-4.1)",
-          "name": "model",
-          "required": true
-        }
-      },
-      "description": "Switch the active model",
+      "args": {},
+      "description": "Show active provider and model",
       "examples": [
-        "<%= config.bin %> model switch claude-sonnet-4-5",
-        "<%= config.bin %> model switch gpt-4.1 --provider openai",
-        "<%= config.bin %> model switch claude-sonnet-4-5 --format json"
+        "<%= config.bin %> providers",
+        "<%= config.bin %> providers --format json"
       ],
       "flags": {
         "format": {
@@ -970,19 +1073,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "provider": {
-          "char": "p",
-          "description": "Provider ID (defaults to active provider)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "model:switch",
+      "id": "providers",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -993,22 +1088,21 @@
         "dist",
         "oclif",
         "commands",
-        "model",
-        "switch.js"
+        "providers",
+        "index.js"
       ]
     },
-    "space:list": {
+    "providers:list": {
       "aliases": [],
       "args": {},
-      "description": "List all teams and spaces",
+      "description": "List all available providers and their connection status",
       "examples": [
-        "<%= config.bin %> space list",
-        "<%= config.bin %> space list --format json"
+        "<%= config.bin %> providers list",
+        "<%= config.bin %> providers list --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1022,7 +1116,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:list",
+      "id": "providers:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1033,22 +1127,27 @@
         "dist",
         "oclif",
         "commands",
-        "space",
+        "providers",
         "list.js"
       ]
     },
-    "space:switch": {
+    "providers:switch": {
       "aliases": [],
-      "args": {},
-      "description": "Switch to a different space",
+      "args": {
+        "provider": {
+          "description": "Provider ID to switch to (e.g., anthropic, openai)",
+          "name": "provider",
+          "required": true
+        }
+      },
+      "description": "Switch the active provider",
       "examples": [
-        "<%= config.bin %> space switch --team acme --name my-space",
-        "<%= config.bin %> space switch --team acme --name my-space --format json"
+        "<%= config.bin %> providers switch anthropic",
+        "<%= config.bin %> providers switch openai --format json"
       ],
       "flags": {
         "format": {
-          "char": "f",
-          "description": "Output format",
+          "description": "Output format (text or json)",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1058,29 +1157,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "name": {
-          "char": "n",
-          "description": "Name of the space to switch to",
-          "name": "name",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "team": {
-          "char": "t",
-          "description": "Team name",
-          "name": "team",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "space:switch",
+      "id": "providers:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1091,44 +1172,19 @@
         "dist",
         "oclif",
         "commands",
-        "space",
+        "providers",
         "switch.js"
       ]
     },
-    "providers:connect": {
+    "model": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "Provider ID to connect (e.g., anthropic, openai, openrouter)",
-          "name": "provider",
-          "required": true
-        }
-      },
-      "description": "Connect or switch to an LLM provider",
+      "args": {},
+      "description": "Show the active model",
       "examples": [
-        "<%= config.bin %> providers connect anthropic --api-key sk-xxx",
-        "<%= config.bin %> providers connect openai --api-key sk-xxx --model gpt-4.1",
-        "<%= config.bin %> providers connect byterover",
-        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1",
-        "<%= config.bin %> providers connect openai-compatible --base-url http://localhost:11434/v1 --api-key sk-xxx --model llama3"
+        "<%= config.bin %> model",
+        "<%= config.bin %> model --format json"
       ],
       "flags": {
-        "api-key": {
-          "char": "k",
-          "description": "API key for the provider",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "base-url": {
-          "char": "b",
-          "description": "Base URL for OpenAI-compatible providers (e.g., http://localhost:11434/v1)",
-          "name": "base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
         "format": {
           "description": "Output format (text or json)",
           "name": "format",
@@ -1140,19 +1196,11 @@
             "json"
           ],
           "type": "option"
-        },
-        "model": {
-          "char": "m",
-          "description": "Model to set as active after connecting",
-          "name": "model",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:connect",
+      "id": "model",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1163,23 +1211,17 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "connect.js"
+        "model",
+        "index.js"
       ]
     },
-    "providers:disconnect": {
+    "model:list": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "Provider ID to disconnect",
-          "name": "provider",
-          "required": true
-        }
-      },
-      "description": "Disconnect an LLM provider",
+      "args": {},
+      "description": "List available models from all connected providers",
       "examples": [
-        "<%= config.bin %> providers disconnect anthropic",
-        "<%= config.bin %> providers disconnect openai --format json"
+        "<%= config.bin %> model list",
+        "<%= config.bin %> model list --format json"
       ],
       "flags": {
         "format": {
@@ -1193,11 +1235,19 @@
             "json"
           ],
           "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Only list models for a specific provider",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:disconnect",
+      "id": "model:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1208,17 +1258,24 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "disconnect.js"
+        "model",
+        "list.js"
       ]
     },
-    "providers": {
+    "model:switch": {
       "aliases": [],
-      "args": {},
-      "description": "Show active provider and model",
+      "args": {
+        "model": {
+          "description": "Model ID to switch to (e.g., claude-sonnet-4-5, gpt-4.1)",
+          "name": "model",
+          "required": true
+        }
+      },
+      "description": "Switch the active model",
       "examples": [
-        "<%= config.bin %> providers",
-        "<%= config.bin %> providers --format json"
+        "<%= config.bin %> model switch claude-sonnet-4-5",
+        "<%= config.bin %> model switch gpt-4.1 --provider openai",
+        "<%= config.bin %> model switch claude-sonnet-4-5 --format json"
       ],
       "flags": {
         "format": {
@@ -1232,11 +1289,19 @@
             "json"
           ],
           "type": "option"
+        },
+        "provider": {
+          "char": "p",
+          "description": "Provider ID (defaults to active provider)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers",
+      "id": "model:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1247,21 +1312,22 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
-        "index.js"
+        "model",
+        "switch.js"
       ]
     },
-    "providers:list": {
+    "space:list": {
       "aliases": [],
       "args": {},
-      "description": "List all available providers and their connection status",
+      "description": "List all teams and spaces",
       "examples": [
-        "<%= config.bin %> providers list",
-        "<%= config.bin %> providers list --format json"
+        "<%= config.bin %> space list",
+        "<%= config.bin %> space list --format json"
       ],
       "flags": {
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1275,7 +1341,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:list",
+      "id": "space:list",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1286,27 +1352,22 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
+        "space",
         "list.js"
       ]
     },
-    "providers:switch": {
+    "space:switch": {
       "aliases": [],
-      "args": {
-        "provider": {
-          "description": "Provider ID to switch to (e.g., anthropic, openai)",
-          "name": "provider",
-          "required": true
-        }
-      },
-      "description": "Switch the active provider",
+      "args": {},
+      "description": "Switch to a different space",
       "examples": [
-        "<%= config.bin %> providers switch anthropic",
-        "<%= config.bin %> providers switch openai --format json"
+        "<%= config.bin %> space switch --team acme --name my-space",
+        "<%= config.bin %> space switch --team acme --name my-space --format json"
       ],
       "flags": {
         "format": {
-          "description": "Output format (text or json)",
+          "char": "f",
+          "description": "Output format",
           "name": "format",
           "default": "text",
           "hasDynamicHelp": false,
@@ -1316,11 +1377,29 @@
             "json"
           ],
           "type": "option"
+        },
+        "name": {
+          "char": "n",
+          "description": "Name of the space to switch to",
+          "name": "name",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "team": {
+          "char": "t",
+          "description": "Team name",
+          "name": "team",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:switch",
+      "id": "space:switch",
       "pluginAlias": "byterover-cli",
       "pluginName": "byterover-cli",
       "pluginType": "core",
@@ -1331,7 +1410,7 @@
         "dist",
         "oclif",
         "commands",
-        "providers",
+        "space",
         "switch.js"
       ]
     },
@@ -1534,5 +1613,5 @@
       ]
     }
   },
-  "version": "2.1.4"
+  "version": "2.2.0"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "byterover-cli",
   "description": "ByteRover's CLI",
-  "version": "2.1.4",
+  "version": "2.2.0",
   "author": "ByteRover",
   "bin": {
     "brv": "./bin/run.js"