codex-wsl-remote

Manage Codex app-server sessions in WSL through SSH connections.

Updated Jun 4, 2026
One-click install
npx skills add https://github.com/rickylabs/netscript --skill codex-wsl-remote
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codex-wsl-remote
Source: https://github.com/rickylabs/netscript/tree/main/.agents/skills/codex-wsl-remote
Command: npx skills add https://github.com/rickylabs/netscript --skill codex-wsl-remote

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill enables remote control of NetScript Codex through WSL SSH, providing secure and efficient management of app-server sessions.

Core Features & Use Cases

  • WSL SSH Access: Establish a secure SSH connection to WSL for remote management.
  • App-Server Session Control: Start, resume, and steer app-server sessions without interrupting active work.
  • Native WSL Paths: Utilizes native WSL worktree paths for smooth operation, avoiding DrvFS issues.
  • Use Case: When managing a Codex app-server that needs to interact with local worktrees through WSL, this skill simplifies the process by enabling remote control without the need for manual intervention.

Quick Start

Connect to your WSL environment and run 'codex debug app-server send-message-v2 "<prompt>"' to start a new session.

Frequently Asked Questions about codex-wsl-remote

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I control a NetScript Codex app-server session through WSL SSH?

To control a NetScript Codex app-server session through WSL SSH, you establish a secure SSH connection to your WSL environment and use the 'codex debug app-server send-message-v2' command to start, resume, or steer sessions remotely.

Can I manage Codex app-server sessions in WSL without interrupting active work?

Yes, you can manage Codex app-server sessions in WSL without interrupting active work. The skill enables you to start, resume, and steer app-server sessions remotely over SSH, ensuring seamless session handling without manual intervention.

Do I need SSH key setup to use Codex remote control in WSL?

Yes, you need SSH key setup to use Codex remote control in WSL. A configured Codex environment and proper SSH key setup are required to establish a secure connection and manage app-server sessions effectively.

What's the best way to avoid DrvFS issues when using native WSL worktree paths with Codex?

The best way to avoid DrvFS issues when using native WSL worktree paths with Codex is to use this skill, which utilizes native WSL paths for smooth operation. This approach ensures smooth interaction with local worktrees without DrvFS complications.

How does WSL SSH remote control simplify NetScript Codex session management?

WSL SSH remote control simplifies NetScript Codex session management by providing secure access and efficient handling of app-server sessions. It allows you to interact with local worktrees through WSL, eliminating the need for manual intervention.

What limitations exist when steering Codex sessions across different WSL distros?

The skill supports various WSL distros for steering Codex sessions, but it requires a properly configured Codex environment and SSH connections. Without these prerequisites, session management across different WSL distros may fail.