local-agent-session

Launch tmux terminal sessions for agents with persisted history and workspace context.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/itismyfield/rcc-pcd-bootstrap --skill local-agent-session
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: local-agent-session
Source: https://github.com/itismyfield/rcc-pcd-bootstrap/tree/main/skills/local-agent-session
Command: npx skills add https://github.com/itismyfield/rcc-pcd-bootstrap --skill local-agent-session

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill allows users to seamlessly open a local terminal session for an agent, enabling direct interaction with the agent's environment and continuing conversations from where they left off.

Core Features & Use Cases

  • Local Terminal Access: Launches a tmux session for the agent on the local machine or a specified remote host.
  • Session Persistence: Continues previous conversations by automatically loading the workspace and session history.
  • Flexible Modes: Supports 'continue' (default), 'pick' (select conversation), 'new' (start fresh), and 'headless' (tmux only) modes.
  • Provider Agnostic: Works with both 'claude' and 'codex' providers, respecting channel-specific configurations.
  • Use Case: When you need to debug an agent's behavior or perform complex tasks that are easier in a terminal, you can use this skill to open a dedicated session.

Quick Start

Use the local-agent-session skill to open a new local terminal session for the current agent.

Frequently Asked Questions about local-agent-session

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

FAQPage Schema
How do I open a local terminal session for an AI agent?

To open a local terminal session for an AI agent, you can launch a tmux session that persists conversation history and workspace context. This enables direct interaction with the agent's environment on your local machine or a specified remote host.

Can I continue a previous agent conversation in a new tmux terminal?

Yes, you can continue a previous agent conversation by using the 'continue' mode. This default mode automatically loads the existing workspace and session history, allowing you to pick up exactly where you left off in the terminal.

Does this terminal session tool support both Claude and Codex providers?

Yes, the terminal session tool is provider agnostic and supports both Claude and Codex. It respects channel-specific configurations for each provider, establishing the correct environment by integrating with role mapping and identity files.

What is the best way to run a headless agent session without an interactive terminal?

The best way to run a headless agent session is by using the 'headless' mode. This mode launches the agent within a tmux session only, allowing background execution without attaching to an interactive terminal interface.

How do I select a specific agent conversation to resume in the terminal?

To select a specific agent conversation to resume, use the 'pick' mode when launching the local terminal session. This mode allows you to choose from previous conversations before loading the associated workspace and session history.

Why do I need tmux to manage local agent terminal sessions?

You need tmux to manage local agent terminal sessions because it enables persistent background execution and session continuity. It allows the agent to maintain its workspace context and conversation history across detachable terminal instances.