ctxttools 0.2.0__tar.gz → 0.2.1__tar.gz

{ctxttools-0.2.0/ctxttools.egg-info → ctxttools-0.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ctxttools
-Version: 0.2.0
+Version: 0.2.1
 Summary: CLI tools for LLM conversations
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -18,14 +18,47 @@ Dynamic: license-file
 <p align="center">
 <img width="500" alt="ctools" src="https://github.com/user-attachments/assets/ee781bbe-6364-44ed-be2d-72114f1e6d8a" /><br/>
 <a href=https://pypi.org/project/ctxttools><img src=https://badge.fury.io/py/ctxttools.svg/></a>
+<br/><br/><b>Try it now</b><br/>
+<code>uvx --from ctxttools cdir</code>
+<br/><br/><b>Then install it</b><br/>
+<code>uv tool install ctxttools</code>
 </p>
 
 ------
+**ctools** is a suite of simple tools for navigating through the sessions in various agents. It allows you to search your history, transfer conversations, filter them, and even share them among hosts and users through ssh.
 
-Grep through your conversation history in Claude Desktop, Claude Code, Codex, Pi, Hermes, Goose, Kilo, Hermes, FreeBuff, Cline, and omp.
+It supports [Claude Desktop](https://claude.com/download), [Claude Code](https://github.com/anthropics/claude-code), [Codex](https://github.com/openai/codex), [Pi](https://github.com/earendil-works/pi), [Hermes](https://github.com/NousResearch/hermes-agent), [Goose](https://github.com/aaif-goose/goose), [Kilo](https://github.com/Kilo-Org/kilocode), [Hermes](https://github.com/NousResearch/hermes-agent), [FreeBuff](https://github.com/CodebuffAI/freebuff), [Cline](https://github.com/cline/cline), and [omp](https://github.com/can1357/oh-my-pi).
 
-Copy your conversation from one to another. Start in one program, continue in another. using the normal resume syntax.
+Here's an example:
 
+> I look for mentions of snake game in opencode using cgrep
+<pre>
+$ <b>cgrep</b> "snake game" opencode
+opencode/ses_a1d1a5a4df984ee698cab4a7:1:user: make a simple snake game in python
+opencode/ses_a1d1a5a4df984ee698cab4a7:2:assistant: I'll make a terminal-based snake game using `curses` (standard library, no dependencies).
+opencode/ses_a1d1a5a4df984ee698cab4a7:3:assistant: Done — `snake.py` is a terminal snake game using Python's built-in `curses` module (no dependencies).
+</pre>
+
+> cool let's look at the status of that session using cdir
+<pre>
+$ <b>cdir</b> -l opencode/ses_a1d1a5a4df984ee698cab4a7
+  ID                            NAME                                MODIFIED            SIZE  MSGS  PATH
+  ses_a1d1a5a4df984ee698cab4a7  make a simple snake game in python  2026-10-07 16:56  2.7 KB     3  /home/chris/.local/share/opencode
+
+  1 session(s)
+</pre>
+
+> Alright let's copy that session from opencode into pi!
+<pre>
+$ <b>ccopy</b> opencode/ses_a1d1a5a4df984ee698cab4a7 pi
+Copied 3 message(s) from opencode/ses_a1d1a5a4df984ee698cab4a7 to a new pi session: e357f435-f813-463a-b313-f97f1051f3cb
+Resume it with:
+  pi --session e357f435-f813-463a-b313-f97f1051f3cb
+</pre>
+
+As you can see, these are unix-friendly tools using simple paradigms that you are already familiar with.
+
+----
 
 ### 1. `cgrep` — find it in your past conversations
 
@@ -51,9 +84,9 @@ Resume it with:
   claude-code --resume 1a2b3c
 ```
 
-Your work travels with you. The source is never touched, so it's a true copy. And when the destination is on another machine, it's just `ccopy opencode/ses_abc123 ssh://chris@remote/codex` — it runs over your normal ssh.
+Your work travels with you. The source is never touched, so it's a true copy. And when the destination is on another machine, it's just `ccopy opencode/ses_abc123 ssh://chris@remote/codex` — it pulls the agent's storage over your normal ssh (the remote only needs `sshd` and `tar`, not ctools).
 
-ctools is a set of GNU-style tools for the history your coding agents leave behind. These two are the headline; the rest (`cdir` to list sessions, `cextract` to move concepts, `cconnect` to pipe them live, `cdu` to count tokens, `crm` to prune) are in service of them.
+ctools is a set of GNU-style tools for the history your coding agents leave behind. These two are the headline; the rest (`cdir` to list sessions, `ccat` to read them, `cextract` to move concepts, `cconnect` to pipe them live, `cdu` to count tokens, `crm` to prune) are in service of them.
 
 **Works with the agents you already use:** Claude Desktop, Claude Code, Opencode, Kilo, Codex, Pi, Goose, Hermes, Cline, omp (oh-my-pi), and Freebuff (Codebuff).
 
@@ -63,13 +96,14 @@ ctools is a set of GNU-style tools for the history your coding agents leave behi
 |------|--------------|------|
 | `cgrep` | Search conversation content (grep across every agent) | [docs/cgrep.md](docs/cgrep.md) |
 | `cdir` | List sessions (ls for your history) | [docs/cdir.md](docs/cdir.md) |
+| `ccat` | Print one or more conversations (cat for your history) | [docs/ccat.md](docs/ccat.md) |
 | `ccopy` | Copy a whole conversation from one agent to a new session in another | [docs/ccopy.md](docs/ccopy.md) |
 | `cextract` | Extract concepts from a session into files, and inject them back | [docs/cextract.md](docs/cextract.md) |
 | `cconnect` | Live concept pipelines between sessions | [docs/cconnect.md](docs/cconnect.md) |
 | `cdu` | Token usage per session (du for context windows) | [docs/cdu.md](docs/cdu.md) |
 | `crm` | Remove concepts from a session (mdel) | [docs/crm.md](docs/crm.md) |
 
-Every tool takes `--version` and `--verbose` (structured logging). Each tool's full flag reference, output formats, and examples live in its `docs/` page — the table above is just the 30-second version.
+Every tool takes `--version`. The session-mover tools (`ccopy`, `cextract`, `cconnect`, `crm`) also take `--verbose` for structured logging. Each tool's full flag reference, output formats, and examples live in its `docs/` page — the table above is just the 30-second version.
 
 ## How it works
 

{ctxttools-0.2.0 → ctxttools-0.2.1}/README.md

@@ -1,14 +1,47 @@
 <p align="center">
 <img width="500" alt="ctools" src="https://github.com/user-attachments/assets/ee781bbe-6364-44ed-be2d-72114f1e6d8a" /><br/>
 <a href=https://pypi.org/project/ctxttools><img src=https://badge.fury.io/py/ctxttools.svg/></a>
+<br/><br/><b>Try it now</b><br/>
+<code>uvx --from ctxttools cdir</code>
+<br/><br/><b>Then install it</b><br/>
+<code>uv tool install ctxttools</code>
 </p>
 
 ------
+**ctools** is a suite of simple tools for navigating through the sessions in various agents. It allows you to search your history, transfer conversations, filter them, and even share them among hosts and users through ssh.
 
-Grep through your conversation history in Claude Desktop, Claude Code, Codex, Pi, Hermes, Goose, Kilo, Hermes, FreeBuff, Cline, and omp.
+It supports [Claude Desktop](https://claude.com/download), [Claude Code](https://github.com/anthropics/claude-code), [Codex](https://github.com/openai/codex), [Pi](https://github.com/earendil-works/pi), [Hermes](https://github.com/NousResearch/hermes-agent), [Goose](https://github.com/aaif-goose/goose), [Kilo](https://github.com/Kilo-Org/kilocode), [Hermes](https://github.com/NousResearch/hermes-agent), [FreeBuff](https://github.com/CodebuffAI/freebuff), [Cline](https://github.com/cline/cline), and [omp](https://github.com/can1357/oh-my-pi).
 
-Copy your conversation from one to another. Start in one program, continue in another. using the normal resume syntax.
+Here's an example:
 
+> I look for mentions of snake game in opencode using cgrep
+<pre>
+$ <b>cgrep</b> "snake game" opencode
+opencode/ses_a1d1a5a4df984ee698cab4a7:1:user: make a simple snake game in python
+opencode/ses_a1d1a5a4df984ee698cab4a7:2:assistant: I'll make a terminal-based snake game using `curses` (standard library, no dependencies).
+opencode/ses_a1d1a5a4df984ee698cab4a7:3:assistant: Done — `snake.py` is a terminal snake game using Python's built-in `curses` module (no dependencies).
+</pre>
+
+> cool let's look at the status of that session using cdir
+<pre>
+$ <b>cdir</b> -l opencode/ses_a1d1a5a4df984ee698cab4a7
+  ID                            NAME                                MODIFIED            SIZE  MSGS  PATH
+  ses_a1d1a5a4df984ee698cab4a7  make a simple snake game in python  2026-10-07 16:56  2.7 KB     3  /home/chris/.local/share/opencode
+
+  1 session(s)
+</pre>
+
+> Alright let's copy that session from opencode into pi!
+<pre>
+$ <b>ccopy</b> opencode/ses_a1d1a5a4df984ee698cab4a7 pi
+Copied 3 message(s) from opencode/ses_a1d1a5a4df984ee698cab4a7 to a new pi session: e357f435-f813-463a-b313-f97f1051f3cb
+Resume it with:
+  pi --session e357f435-f813-463a-b313-f97f1051f3cb
+</pre>
+
+As you can see, these are unix-friendly tools using simple paradigms that you are already familiar with.
+
+----
 
 ### 1. `cgrep` — find it in your past conversations
 
@@ -34,9 +67,9 @@ Resume it with:
   claude-code --resume 1a2b3c
 ```
 
-Your work travels with you. The source is never touched, so it's a true copy. And when the destination is on another machine, it's just `ccopy opencode/ses_abc123 ssh://chris@remote/codex` — it runs over your normal ssh.
+Your work travels with you. The source is never touched, so it's a true copy. And when the destination is on another machine, it's just `ccopy opencode/ses_abc123 ssh://chris@remote/codex` — it pulls the agent's storage over your normal ssh (the remote only needs `sshd` and `tar`, not ctools).
 
-ctools is a set of GNU-style tools for the history your coding agents leave behind. These two are the headline; the rest (`cdir` to list sessions, `cextract` to move concepts, `cconnect` to pipe them live, `cdu` to count tokens, `crm` to prune) are in service of them.
+ctools is a set of GNU-style tools for the history your coding agents leave behind. These two are the headline; the rest (`cdir` to list sessions, `ccat` to read them, `cextract` to move concepts, `cconnect` to pipe them live, `cdu` to count tokens, `crm` to prune) are in service of them.
 
 **Works with the agents you already use:** Claude Desktop, Claude Code, Opencode, Kilo, Codex, Pi, Goose, Hermes, Cline, omp (oh-my-pi), and Freebuff (Codebuff).
 
@@ -46,13 +79,14 @@ ctools is a set of GNU-style tools for the history your coding agents leave behi
 |------|--------------|------|
 | `cgrep` | Search conversation content (grep across every agent) | [docs/cgrep.md](docs/cgrep.md) |
 | `cdir` | List sessions (ls for your history) | [docs/cdir.md](docs/cdir.md) |
+| `ccat` | Print one or more conversations (cat for your history) | [docs/ccat.md](docs/ccat.md) |
 | `ccopy` | Copy a whole conversation from one agent to a new session in another | [docs/ccopy.md](docs/ccopy.md) |
 | `cextract` | Extract concepts from a session into files, and inject them back | [docs/cextract.md](docs/cextract.md) |
 | `cconnect` | Live concept pipelines between sessions | [docs/cconnect.md](docs/cconnect.md) |
 | `cdu` | Token usage per session (du for context windows) | [docs/cdu.md](docs/cdu.md) |
 | `crm` | Remove concepts from a session (mdel) | [docs/crm.md](docs/crm.md) |
 
-Every tool takes `--version` and `--verbose` (structured logging). Each tool's full flag reference, output formats, and examples live in its `docs/` page — the table above is just the 30-second version.
+Every tool takes `--version`. The session-mover tools (`ccopy`, `cextract`, `cconnect`, `crm`) also take `--verbose` for structured logging. Each tool's full flag reference, output formats, and examples live in its `docs/` page — the table above is just the 30-second version.
 
 ## How it works