@ycodium-ai/plugin-session-import 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +61 -0
- package/dist/index.js +1954 -0
- package/package.json +54 -0
package/README.md
ADDED
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# @ycodium-ai/plugin-session-import
|
|
2
|
+
|
|
3
|
+
Bring a Claude or Codex session you started in a terminal into Ycodium as a
|
|
4
|
+
thread. Ycodium takes the session over rather than copying it: the agent keeps
|
|
5
|
+
its full memory, and continuing in Ycodium continues the same native session.
|
|
6
|
+
|
|
7
|
+
## What it does
|
|
8
|
+
|
|
9
|
+
Three commands:
|
|
10
|
+
|
|
11
|
+
- **scan** — lists Claude and Codex sessions under a project directory.
|
|
12
|
+
- **import** — takes one over and reports each phase (read, create, link).
|
|
13
|
+
- **sync** — picks up what a terminal wrote to **one** already-imported
|
|
14
|
+
session. The client calls this when you open that thread and just before
|
|
15
|
+
you send the next message. There is no background sweep.
|
|
16
|
+
|
|
17
|
+
Reading provider directories uses the `providers.homes` permission. Spawning
|
|
18
|
+
`codex app-server` uses `config:codexBinaries`, which the host injects from
|
|
19
|
+
the Codex instances configured on this machine. The plugin never ships those
|
|
20
|
+
binaries.
|
|
21
|
+
|
|
22
|
+
## Requirements
|
|
23
|
+
|
|
24
|
+
A Ycodium server. The plugin asks to:
|
|
25
|
+
|
|
26
|
+
- read every provider instance's home, transcript, and config directories
|
|
27
|
+
- spawn Codex binaries the host names
|
|
28
|
+
- dispatch `thread.import` and `thread.external-messages.append` on threads
|
|
29
|
+
it imported
|
|
30
|
+
|
|
31
|
+
## Install
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
ycodium plugin add @ycodium-ai/plugin-session-import
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
The plugin ships enabled with Ycodium as `core.session-import`. Disabling it
|
|
38
|
+
stops scan, import, and sync. Uninstalling it writes a removal onto the home
|
|
39
|
+
patch, so a restart or upgrade does not bring it back. Reinstalling the
|
|
40
|
+
unversioned bundled package restores the same entry without an npm fetch.
|
|
41
|
+
Imported threads and their history stay.
|
|
42
|
+
|
|
43
|
+
## Surfaces
|
|
44
|
+
|
|
45
|
+
The picker is host chrome, not a plugin page:
|
|
46
|
+
|
|
47
|
+
- **Web / Desktop** — project header in the thread list, terminal button.
|
|
48
|
+
- **Mobile** — the same control, always visible.
|
|
49
|
+
|
|
50
|
+
All three call this package's `scan` / `import` / `sync` commands. There is
|
|
51
|
+
no settings card.
|
|
52
|
+
|
|
53
|
+
## Developing
|
|
54
|
+
|
|
55
|
+
The package builds its own code into `dist/index.js`. The host supplies the
|
|
56
|
+
shared `@ycodium-ai/plugin-api` at runtime. The plugin requires plugin API
|
|
57
|
+
version 2.
|
|
58
|
+
|
|
59
|
+
## License
|
|
60
|
+
|
|
61
|
+
UNLICENSED.
|