Rovo Dev CLI 設定を管理する

Rovo Dev CLI 構成ファイルは既定では ~/.rovodev/config.yml に保存されます。好みやワークフローに合わせて Rovo Dev CLI をカスタマイズするには、このファイルの設定を変更してください。

既定のエディターでファイルを編集するには、次のコマンドを実行します。

acli rovodev config

設定オプション

構成ファイルでは、階層構造を持つ YAML 形式が使用されます。構成パラメーターはすべてオプションです。パラメーターを指定しなければ、Rovo Dev では適切な既定値が使用されます。

Rovo Dev の動作

Rovo Dev の応答方法を制御する設定です。

agent:
  # Additional system prompt to append to the agent's default system prompt
  additionalSystemPrompt: "Always prioritize code readability and maintainability."

  # Enable streaming responses from the AI model (default: true)
  streaming: true

  # Temperature setting for AI model responses (0.0-1.0, default: 0.3)
  temperature: 0.3

  # Model ID to use for the agent (default: "auto")
  modelId: "auto"

  # Enable the deep planning tool for complex task planning (default: false)
  enableDeepPlanTool: false

  experimental:
    # Enable task delegation to sub-agents (internal users only)
    enableDelegationTool: false

    # Disable built-in Atlassian MCP server (internal users only)
    disableBuiltinAtlassianMcp: false

セッション

sessions:
  # Directory where session data is stored
  persistenceDir: "~/.rovodev/sessions"
  
  # (Experimental) When enabled, Rovo Dev may warn and offer to switch your
  # workspace git state (branch/commit) to match the session checkpoint when
  # restoring or switching sessions.
  enableWorkspaceStateSync: false

アトラシアン接続

Rovo Dev で使用される Atlassian アプリコンテキストを制御する設定です。

atlassianConnections:
  # Global Jira projects user is part of
  jiraProjects:
    - url: "https://yoursite.atlassian.net/browse/PROJ"
      key: "PROJ"
      name: "Your Project"

  # Directory where local overrides are stored
  localOverridePath: "~/.rovodev/atlassian_local_overrides"

  # Whether Atlassian integration is enabled (default: true)
  enabled: true

コンソール

Rovo Dev CLI での情報表示および入力処理の方法を制御する設定です。

console:
  # Output format for console display (markdown, simple, or raw)
  outputFormat: markdown
  
  # Show tool execution results in the console
  showToolResults: true
  
  # Per-tool configuration for whether to show tool execution results in the
  # console
  toolResultVisibility:
    bash: true
    powershell: true
    open_files: true
    create_file: true
    delete_file: true
    move_file: true
    expand_code_chunks: true
    find_and_replace_code: true
    grep: true
    expand_folder: true
    update_allowed_external_paths: true
  
  # Editing mode for the prompt session
  editingMode: EMACS
  
  # Shell command to generate a command prompt that replaces the default '> '.
  # For example, set 'STARSHIP_SHELL=rovodev starship prompt' to use Starship.
  customCommandPrompt: null
  
  # Color theme for syntax highlighting. Options: 'dark' (Dracula), 'light',
  # 'auto' (detect system theme), or any [Pygments theme
  # name](https://pygments.org/styles/)(e.g., 'monokai', 'solarized-light')
  theme: textual-dark (bg)
  
  # Maximum width of the console output in characters, or 'fill' to fill the
  # terminal width
  maxOutputWidth: 120
  
  # Enable or disable animated startup loading screen
  enableStartupAnimations: true
  
  # Automatically copy selected text to clipboard when text is selected in the
  # chat
  copyOnSelect: true
  
  # Terminal tab title settings
  terminalTitle:
    # Enable or disable automatic terminal tab title updates
    isEnabled: true
    
    # Terminal tab title format string. Supported template variables:   • {cwd}
    # — workspace directory name   • {project} — full workspace path   •
    # {branch}  — current git branch   • {session} — session title   • {model}
    # — current model name
    displayValue: 'Rovo Dev: {session} | branch: {branch}'

ログ

logging:
  # Path to the log file (default: ~/.rovodev/logs/rovodev.log)
  path: "~/.rovodev/logs/rovodev.log"

  # Enable collection of prompts for debugging (internal users only)
  enablePromptCollection: false

MCP (Model Context Protocol)

MCP サーバー接続を設定します。サードパーティデータソースに接続する場合は、アトラシアンが該当するデータを使用するために必要な権利、同意、承認を取得し、サードパーティ製品からのデータの使用に関する利用規約を遵守する必要があります。Rovo Dev と MCP の詳細については、こちらをご確認ください。

mcp:
  # Path to the MCP configuration file (default: ~/.rovodev/mcp_config.json)
  mcpConfigPath: "~/.rovodev/mcp_config.json"

  # List of allowed MCP server names
  allowedMcpServers: []

  # List of globally disabled MCP server signatures
  disabledMcpServers: []

ツール

使用可能なツールとツール使用前の確認の有無を制御します。

toolPermissions:
  # Default permission for tools not explicitly listed (default: "ask")
  # Options: "allow", "ask", "deny"
  default: "ask"

  # Permission settings for specific tools
  tools:
    # File operations
    create_file: "ask"
    delete_file: "ask"
    move_file: "ask"
    find_and_replace_code: "ask"

    # Safe read operations
    open_files: "allow"
    expand_code_chunks: "allow"
    expand_folder: "allow"
    grep: "allow"

    # Planning tools
    createTechnicalPlan: "allow"

    # Atlassian integration tools
    getJiraIssue: "allow"
    createJiraIssue: "ask"
    updateJiraIssue: "ask"
    getConfluencePage: "allow"
    createConfluencePage: "ask"
    updateConfluencePage: "ask"

  # Bash command permissions
  bash:
    # Default permission for bash commands (default: "ask")
    default: "ask"

    # Specific bash commands with permissions
    commands:
      - command: "ls.*"
        permission: "allow"
      - command: "cat.*"
        permission: "allow"
      - command: "echo.*"
        permission: "allow"
      - command: "pwd"
        permission: "allow"

    # Run bash commands in sandboxed environment (macOS only, internal users)
    runInSandbox: false

  # File/directory paths allowed outside workspace
  allowedExternalPaths: []

Rovo Dev クレジット

Rovo Dev CLI に使用できる Rovo Dev クレジットが割り当てられたサイトを設定します。

atlassianBillingSite:
  siteUrl: "https://yoursite.atlassian.net"
  cloudId: "your-cloud-id"

新しい構成ファイルを使用する

カスタムの場所に新しい構成ファイルを設定するには、--config-file フラグの後に新しい場所を指定して Rovo Dev を実行します。ファイルが存在しない場合は自動的に作成されます。次に例を示します。

acli rovodev run --config-file ~/.rovodev/new-configuration.yml

この内容はお役に立ちましたか?

正確ではなかった明確ではなかった関係なかった

さらにヘルプが必要ですか?

アトラシアンコミュニティをご利用ください。

コミュニティに質問