vlinx-io / vopen
Open a file or URL in the vlx-term center pane (mirrors the `vopen` command). Markdown opens in a WYSIWYG editor, images in the built-in image viewer, other files in the source-code editor (with automatic syntax highlighting by language), and http/https URLs in a built-in browser tab. Only use when the user explicitly invokes /vopen or $vopen; never auto-trigger. Available only inside vlx-term-hosted local sessions.
/vopen
The user explicitly invoked /vopen (Claude) or $vopen (Codex) to request opening a file or URL in the
vlx-term center pane, with exactly the same effect
as typing vopen <file> in the terminal: it opens a document tab in the center pane, routed automatically by type
(markdown WYSIWYG / image viewer / code editor with syntax highlighting), while http/https URLs open a built-in
browser tab. The document tab sits alongside the terminal tabs and won't displace the current session.
User input:
$ARGUMENTS
Step 1: Resolve the user input into concrete paths
What the user gives may be a literal path or URL, or a reference (e.g. "the file I just edited," "the
architecture doc") — resolve references into real file paths from the current conversation context; when unsure,
ask first rather than guessing a path to open.- Multiple items can be opened at once; resolve each one.
Always convert to an absolute path before passing it to the command (the Bash tool's working directory isn't
necessarily the "current directory" the user has in mind; absolute paths are the most reliable). Pass URLs
(http/https) through as-is.- The file must already exist;
vopenonly accepts regular files, not directories.
Step 2: Run the command
Run vopen from PATH (each path/URL as a separate argument; mind escaping of spaces and other special characters):
vopen <absolute path or url>...On success it prints a confirmation for each opened item; on failure (file doesn't exist or isn't a regular file)
it exits non-zero and reports which file on stderr.
Step 3: Report back to the user
On success, give a one-line summary: "Opened in vlx-term: <file name>"; on failure, report the failed file and the
reason honestly.
Notes
Must run inside a vlx-term-hosted local session: it relies on the injected
VLX_*environment variables and
thevopenscript on PATH; if missing it reports "not inside a vlx-term session" — in that case just tell the
user this skill is only available inside vlx-term sessions, and don't try other ways to open it.- Not available inside
claude-remoteremote sessions (a remote can't reach the local machine's hook port).