Add ask mode support to the CLI target

- to 'cli' target, add 'ask' prompt type (don't handle yet)
- when in 'ask' CLI prompt type, invoke into the integrated terminal, not in headless mode, with changed command: e.g. `codex "[propt]"` instead of `codex exec "[propt]"`

├── apps
│   └── editor
│       └── src
│           ├── constants
│           │   └── instructions.ts
│           ├── extension.ts
│           ├── utils
│           │   └── headless-cli-invocation
│           │       ├── agents
│           │       │   ├── antigravity.ts
│           │       │   ├── claude.ts
│           │       │   ├── codex.ts
│           │       │   ├── cursor.ts
│           │       │   ├── grok.ts
│           │       │   ├── index.ts
│           │       │   ├── muse.ts
│           │       │   └── opencode.ts
│           │       ├── index.ts
│           │       ├── invoke-headless-cli.ts
│           │       ├── types.ts
│           │       └── utils
│           │           ├── check-command-exists.ts
│           │           ├── format-duration.ts
│           │           └── get-progress-dots.ts
│           └── views
│               └── prompt
│                   ├── backend
│                   │   ├── message-handlers
│                   │   │   ├── handle-copy-prompt.ts
│                   │   │   ├── handle-get-cli-prompt-type.ts
│                   │   │   ├── handle-invoke-headless-cli.ts
│                   │   │   ├── handle-preview-prompt.ts
│                   │   │   ├── handle-save-cli-prompt-type.ts
│                   │   │   └── utils
│                   │   │       └── build-cli-prompt.ts
│                   │   └── prompt-view-provider.ts
│                   ├── frontend
│                   │   ├── Home
│                   │   │   └── Home.tsx
│                   │   ├── Main
│                   │   │   ├── Main.tsx
│                   │   │   └── MainView
│                   │   │       ├── MainView.tsx
│                   │   │       ├── components
│                   │   │       │   └── Header
│                   │   │       │       └── Header.tsx
│                   │   │       ├── hooks
│                   │   │       │   └── use-keyboard-shortcuts.ts
│                   │   │       └── prompt-type-labels.ts
│                   │   └── hooks
│                   │       └── use-prompt
│                   │           ├── hooks
│                   │           │   └── use-instructions.ts
│                   │           └── use-prompt.ts
│                   └── types
│                       └── messages.ts
└── packages
    └── shared
        └── src
            └── types
                └── prompt-types.ts

Author: robertpiosik

README.md

@@ -207,6 +207,27 @@ _Multi-purpose: explanations, code reviews, you name it._
 
 </details>
 
+<details>
+<summary>CLI</summary>
+
+```
+# Files
+
+- `[SELECTED FILE PATH 1]`
+- `[SELECTED FILE PATH 2]`
+
+# Requirements
+
+* This is a read-only session.
+* Read all attached files using their project-relative paths in full, and nothing else.
+
+# Task
+
+[INSTRUCTIONS]
+```
+
+</details>
+
 ### 📄 Code at cursor
 
 _TAB completions from SOTA reasoning models._

apps/editor/src/constants/instructions.ts

@@ -69,6 +69,9 @@ These files contain the core greeting logic and module exports.`
 export const voice_input_instructions =
   'Respond with a transcription of the following audio recording or text "INAUDIBLE", and nothing else.'
 
-export const cli_requirements = `- This is a read-only session.
+export const cli_edit_requirements = `- This is a read-only session.
 - Read all attached files using their project-relative paths in full, and nothing else.
 - Formulate response adhering to the output formatting, in plain text.`
+
+export const cli_ask_requirements = `- This is a read-only session.
+- Read all attached files using their project-relative paths in full, and nothing else.`

apps/editor/src/utils/headless-cli-invocation/agents/antigravity.ts

@@ -11,13 +11,14 @@ export const antigravity_agent: CodingAgent = {
   cmd: 'agy',
   is_installed: () => check_command_exists('agy'),
   get_documentation_url: () => 'https://antigravity.google/docs/cli/headless/',
-  get_args: (prompt: string) => [
+  get_edit_args: (prompt: string) => [
     '-p',
     prompt,
     '--output-format',
     'stream-json',
     '--dangerously-skip-permissions'
   ],
+  get_ask_args: (prompt: string) => ['-p', prompt],
   parse_stream_line: (parsed, report_progress) => {
     if (parsed.event == 'step_update' && parsed.step_update) {
       const step = parsed.step_update

apps/editor/src/utils/headless-cli-invocation/agents/claude.ts

@@ -27,7 +27,7 @@ export const claude_agent: CodingAgent = {
   cmd: 'claude',
   is_installed: () => check_command_exists('claude'),
   get_documentation_url: () => 'https://code.claude.com/docs/en/headless',
-  get_args: (prompt: string) => [
+  get_edit_args: (prompt: string) => [
     '-p',
     prompt,
     '--output-format',
@@ -37,6 +37,7 @@ export const claude_agent: CodingAgent = {
     '--permission-mode',
     'auto'
   ],
+  get_ask_args: (prompt: string) => ['-p', prompt],
   parse_stream_line: (parsed, report_progress) => {
     if (parsed.type == 'stream_event' && parsed.event) {
       if (

apps/editor/src/utils/headless-cli-invocation/agents/codex.ts

@@ -12,7 +12,8 @@ export const codex_agent: CodingAgent = {
   is_installed: () => check_command_exists('codex'),
   get_documentation_url: () =>
     'https://learn.chatgpt.com/docs/non-interactive-mode',
-  get_args: (prompt: string) => ['exec', prompt, '--json'],
+  get_edit_args: (prompt: string) => ['exec', prompt, '--json'],
+  get_ask_args: (prompt: string) => [prompt],
   parse_stream_line: (parsed, report_progress) => {
     if (parsed.type == 'item.started' && parsed.item) {
       const item = parsed.item

apps/editor/src/utils/headless-cli-invocation/agents/cursor.ts

@@ -7,13 +7,14 @@ export const cursor_agent: CodingAgent = {
   cmd: 'agent',
   is_installed: () => check_command_exists('agent'),
   get_documentation_url: () => 'https://cursor.com/docs/cli/headless',
-  get_args: (prompt: string) => [
+  get_edit_args: (prompt: string) => [
     '-p',
     prompt,
     '--output-format',
     'stream-json',
     '--force'
   ],
+  get_ask_args: (prompt: string) => ['-p', prompt],
   parse_stream_line: (parsed, report_progress) => {
     if (parsed.type == 'tool_call') {
       if (parsed.subtype == 'started' || !parsed.subtype) {

apps/editor/src/utils/headless-cli-invocation/agents/grok.ts

@@ -9,7 +9,7 @@ export const grok_agent: CodingAgent = {
   cmd: 'grok',
   is_installed: () => check_command_exists('grok'),
   get_documentation_url: () => 'https://docs.x.ai/build/cli/headless-scripting',
-  get_args: (prompt: string) => {
+  get_edit_args: (prompt: string) => {
     accumulated_output = ''
     return [
       '-p',
@@ -20,6 +20,7 @@ export const grok_agent: CodingAgent = {
       '--no-auto-update'
     ]
   },
+  get_ask_args: (prompt: string) => ['-p', prompt],
   parse_stream_line: (parsed, report_progress) => {
     if (parsed.type === 'tool_call' && parsed.tool) {
       report_progress(parsed.tool)

apps/editor/src/utils/headless-cli-invocation/agents/muse.ts

@@ -13,10 +13,11 @@ export const muse_agent: CodingAgent = {
   is_installed: () => check_command_exists('muse'),
   get_documentation_url: () =>
     'https://dev.meta.ai/docs/muse-code/extending#headless',
-  get_args: (prompt: string) => {
+  get_edit_args: (prompt: string) => {
     accumulated_output = ''
     return ['exec', '--json', '--yolo', prompt]
   },
+  get_ask_args: (prompt: string) => [prompt],
   parse_stream_line: (parsed, report_progress) => {
     const payload = parsed.payload || parsed
     let action_name = ''

apps/editor/src/utils/headless-cli-invocation/agents/opencode.ts

@@ -11,7 +11,14 @@ export const opencode_agent: CodingAgent = {
   cmd: 'opencode',
   is_installed: () => check_command_exists('opencode'),
   get_documentation_url: () => 'https://opencode.ai/docs/cli/',
-  get_args: (prompt: string) => ['run', prompt, '--format', 'json', '--auto'],
+  get_edit_args: (prompt: string) => [
+    'run',
+    prompt,
+    '--format',
+    'json',
+    '--auto'
+  ],
+  get_ask_args: (prompt: string) => [prompt],
   parse_stream_line: (parsed, report_progress) => {
     let action_name = ''
     if (parsed.type == 'tool_use' && parsed.part?.tool) {

apps/editor/src/utils/headless-cli-invocation/invoke-headless-cli.ts

@@ -1,4 +1,5 @@
 import * as vscode from 'vscode'
+import * as os from 'os'
 import { WorkspaceProvider } from '@/context/providers/workspace/workspace-provider'
 import { t } from '@/i18n'
 import { spawn } from 'child_process'
@@ -24,6 +25,7 @@ export const invoke_headless_cli = async (params: {
   last_selected_workspace_state_key: string
   config_key_prefix: string
   show_back_button?: boolean
+  cli_prompt_type?: 'edit-files' | 'ask-about-files'
 }): Promise<
   { agent_output: string; selected_root: string } | undefined | 'back'
 > => {
@@ -506,6 +508,32 @@ export const invoke_headless_cli = async (params: {
         }
       }
 
+      if (params.cli_prompt_type === 'ask-about-files') {
+        const final_prompt = await params.build_prompt(selected_root!)
+        const base_args = agent_info.get_ask_args
+          ? agent_info.get_ask_args(final_prompt)
+          : [final_prompt]
+        const args = [...base_args, ...custom_args]
+
+        const quote_arg = (arg: string) => {
+          if (os.platform() === 'win32') {
+            return `"${arg.replace(/"/g, '""')}"`
+          } else {
+            return `'${arg.replace(/'/g, "'\\''")}'`
+          }
+        }
+
+        const command = [executable, ...args.map(quote_arg)].join(' ')
+        const terminal = vscode.window.createTerminal({
+          name: `${agent_info.label} (Ask)`,
+          cwd: selected_root
+        })
+        terminal.show()
+        terminal.sendText(command)
+
+        return { agent_output: '', selected_root: selected_root! }
+      }
+
       let agent_output = ''
       let raw_stream_output = ''
       let is_cancelled = false
@@ -529,7 +557,7 @@ export const invoke_headless_cli = async (params: {
               return
             }
 
-            const base_args = agent_info.get_args(final_prompt)
+            const base_args = agent_info.get_edit_args(final_prompt)
             const args = [...base_args, ...custom_args]
 
             return new Promise<void>((resolve, reject) => {