Skip to content

Integration idea: WinkTerm Agent API for remote terminal/SSH sessions #4566

@Cznorth

Description

@Cznorth

Summary

WinkTerm is an open-source, self-hosted terminal where AI shares the same PTY session as the user — not a separate chat panel.

Why it may be relevant here

  • Human-in-the-loop terminal ops: AI writes commands to the shell input line; the user presses Enter, edits, or cancels
  • In-terminal chat: type # at the prompt (no alt-tab to a sidecar)
  • HTTP Agent API designed for coding agents: atomic exec with real exit_code, SSE streaming, server-side grep, one-shot SSH run
  • Installable skill: curl http://<host>:8000/api/agent/skill.md — drop into Cursor / Claude Code / Continue skills directory
  • BYO LLM via OpenAI-compatible endpoints; Docker one-liner deploy

Demo

Possible integration ideas

  • Document WinkTerm as a remote terminal backend for agents that need shared PTY + SSH access
  • Ship or link the installable skill in docs/examples
  • Support driving WinkTerm sessions via existing agent workflows

Happy to help with a PR or integration testing.

Metadata

Metadata

Assignees

No one assigned

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions