English | [ํ๊ตญ์ด](README.ko.md) | [ไธญๆ](README.zh.md) | [ๆฅๆฌ่ช](README.ja.md) | [Espaรฑol](README.es.md)
# gaseo (๊ฐ์ธ์ค)
<p align="center">
<img src="assets/gaseo-hero-01.png" alt="gaseo" width="320">
</p>
> **Send the session you're in right now over to Paseo โ and pick it up there.**
[Paseo](https://paseo.app) 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 Start](#quick-start) โข [Why gaseo?](#why-gaseo) โข [How it works](#how-it-works) โข [Features](#features) โข [Commands](#commands) โข [Requirements](#requirements)
---
## 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](https://docs.anthropic.com/claude-code) CLI
- [Paseo](https://paseo.app) installed, with its daemon running (`paseo status`)
- The `paseo` CLI on `PATH`, or at its default install location
---
## License
MIT โ see [LICENSE](LICENSE) and [DISCLAIMER.md](DISCLAIMER.md).
---
<div align="center">
**Your session doesn't have to stay in the terminal.**
</div>