Skip to content

Repository files navigation

English | 한국어 | 中文 | 日本語 | Español

gaseo (가세오)

gaseo

Send the session you're in right now over to Paseo — and pick it up there.

Paseo lists only the agents it launched itself. A session you started by typing claude in a terminal never shows up, and there is no way to resume it from the app. gaseo closes that gap: say "가세오" and the conversation you are having this second appears in Paseo under its own title, ready to continue.

Quick StartWhy gaseo?How it worksFeaturesCommandsRequirements


Quick Start

1. Add the marketplace

/plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git

2. Install

/plugin install gaseo

3. Restart Claude Code

(New commands only register after a restart.)

4. Run

/gaseo

That's it — the session you're in is now in Paseo. Open the app and keep talking.

To bring in older conversations from this folder instead:

/gaseo past

Or just say it:

  • "파세오로 가세오"
  • "이 세션 파세오로 가세오"
  • "가세오 해줘"
  • "register this session to paseo"
  • "import my past sessions into paseo"

Why gaseo?

Your terminal sessions are invisible to Paseo. Paseo shows the agents it started. Everything you ran yourself from a shell — which is most of your real work — simply isn't in the list, and there's no import button in the UI.

It's a link, not a copy. gaseo runs paseo import, which writes nothing but a pointer to the session ID. Your transcript stays exactly where Claude Code put it. Archive the agent in Paseo later and the original conversation is still untouched.

Walk away from the desk mid-task. Register the session, close the laptop, and carry on from the Paseo app — same conversation, same history, no re-explaining.

Nothing gets registered twice. Sessions Paseo already knows about — including the ones Paseo launched — are detected and skipped.

Folders Paseo has never seen are fine. The workspace is created on import.


How it works

/gaseo
  → find this folder's session directory
      ~/.claude/projects/<folder path with non-alphanumerics as '-'>/
  → $CLAUDE_CODE_SESSION_ID if its transcript is here, else newest .jsonl
  → already in ~/.paseo/agents? → skip, report, done
  → paseo import <sessionId> --provider claude --cwd <folder>
  → appears in Paseo under its original title

Paseo stores no conversation of its own. Each agent record holds a persistence.nativeHandle pointer to a Claude session ID — which is why import is instant, needs no daemon restart, and never duplicates your data.


Features

Feature Description
Current-session register /gaseo picks up the session you're talking in, no ID needed
Past-session picker /gaseo past lists earlier sessions with first message, time and registration status
Duplicate-safe Already-registered sessions are reported, not re-imported
New workspaces Imports into folders Paseo has never seen, creating the workspace
Link, not copy Original transcripts are never moved, altered or duplicated
Confirmable detection Shows the first message of the session it picked before you rely on it

Commands

Command Description
/gaseo Register the current session
/gaseo past List this folder's past sessions and choose which to register
/gaseo <folder> Register the current session of another folder
/gaseo past <folder> Past-session picker for another folder

Natural language triggers

  • /gaseo, "파세오로 가세오", "이 세션 파세오로 가세오", "가세오 해줘", "파세오에 등록해줘"
  • "과거 세션 파세오로 가져와줘", "지난 대화 파세오에 추가해줘"
  • "register this session to paseo", "send this session to paseo"
  • "import my past sessions into paseo"

Notes and limits

How the current session is identified. gaseo reads $CLAUDE_CODE_SESSION_ID, the ID Claude Code exports for the live session, and confirms a matching transcript exists in the folder. Only when that is unavailable does it fall back to picking the most recently written transcript — a guess, because background subagents and hook-spawned sessions write into the same directory and are often newer. The output labels which route was used (via=env or via=mtime); on a via=mtime guess, check the first message it prints, or use /gaseo past to choose explicitly.

Claude sessions only. Codex sessions are stored by date rather than by folder, so the folder-to-session mapping this relies on doesn't apply to them yet.

The daemon is never restarted for you. If paseo import fails because the daemon is down, gaseo reports it and stops. Restarting kills every running agent, so that call stays yours.


Requirements

  • Claude Code CLI
  • Paseo installed, with its daemon running (paseo status)
  • The paseo CLI on PATH, or at its default install location

License

MIT — see LICENSE and DISCLAIMER.md.


Your session doesn't have to stay in the terminal.

About

Register a Claude Code session with Paseo so it shows up in the app and you can continue it there.

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages