qwen-code/packages/cli/src/ui/commands/docsCommand.ts

/**
 * @license
 * Copyright 2025 Google LLC
 * SPDX-License-Identifier: Apache-2.0
 */

import open from 'open';
import process from 'node:process';
import {
  type CommandContext,
  type SlashCommand,
  CommandKind,
} from './types.js';
import { MessageType } from '../types.js';
import { t, getCurrentLanguage } from '../../i18n/index.js';

export const docsCommand: SlashCommand = {
  name: 'docs',
  get description() {
    return t('open full Qwen Code documentation in your browser');
  },
  kind: CommandKind.BUILT_IN,
  action: async (context: CommandContext): Promise<void> => {
    const langPath = getCurrentLanguage()?.startsWith('zh') ? 'zh' : 'en';
    const docsUrl = `https://qwenlm.github.io/qwen-code-docs/${langPath}`;

    if (process.env['SANDBOX'] && process.env['SANDBOX'] !== 'sandbox-exec') {
      context.ui.addItem(
        {
          type: MessageType.INFO,
          text: t(
            'Please open the following URL in your browser to view the documentation:\n{{url}}',
            {
              url: docsUrl,
            },
          ),
        },
        Date.now(),
      );
    } else {
      context.ui.addItem(
        {
          type: MessageType.INFO,
          text: t('Opening documentation in your browser: {{url}}', {
            url: docsUrl,
          }),
        },
        Date.now(),
      );
      await open(docsUrl);
    }
  },
};