Practical Agent workflows

# Let the Agent set up your terminal

WispTerm's Agent can now save SSH server profiles with a built-in tool, connect those profiles, inspect terminals, and keep PowerShell beside the Agent on first launch.

SSH profile setup Agent tools
wispterm — Agent + PowerShell
agent
powershell
ssh: lab

    You Create an SSH profile named lab for alice@192.0.2.10:2222.
    WispTerm tool request
    ssh_profile_save name=lab host=192.0.2.10 user=alice port=2222 password=<redacted>
    saved profile="lab" password_saved=true

    ssh_profile_connect profile_name=lab
    connected surface_id=03 tab=2

## Create SSH profiles by asking

This use case came from issue #33: the SSH profile form is not obvious for new users, but an Agent can turn a natural-language request into a saved profile.

### What to ask

Tell the Agent the profile name, host, user, port, and whether a password should be saved. It will call `ssh_profile_save` instead of editing files by hand.

### What gets saved

The profile is stored in WispTerm's normal SSH profile list. Existing profiles are updated by name or host, and new profiles default to port `22`.

### Password handling

Approval text and tool output redact the password. If you omit the password while updating an existing profile, the saved password is preserved.

    Ask:
    Create an SSH profile named lab:
    host 192.0.2.10, user alice, port 2222.
    Save this password, then connect it.

    Agent tools:
    ssh_profile_save
    ssh_profile_connect

## Start with Agent and PowerShell

On a plain first launch, WispTerm opens the AI Agent first and PowerShell second. Session restore and explicit working-directory launches keep their existing behavior.

### Profile exists

The first tab is the default AI profile running with Agent mode enabled. The second tab is the configured PowerShell family shell.

### No AI profile yet

WispTerm opens a terminal placeholder, opens the AI profile setup form on it, and still creates the PowerShell tab beside it.

### Restore wins

When `restore-tabs-on-startup = true` successfully restores a previous session, WispTerm does not add default Agent or PowerShell tabs.

## Good Agent prompts

### SSH onboarding

    Help me set up SSH.
    Create a profile called gpu-box for:
    host gpu.example.com
    user demo
    port 22
    Then connect it.

### Daily terminal work

    Use the PowerShell tab to inspect this repo.
    Find the test command, run it, and summarize
    only the failures that need my attention.