claude-code-tools 0.2.6__tar.gz → 0.2.7__tar.gz

{claude_code_tools-0.2.6 → claude_code_tools-0.2.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-code-tools
-Version: 0.2.6
+Version: 0.2.7
 Summary: Collection of tools for working with Claude Code
 License-File: LICENSE
 Requires-Python: >=3.11
@@ -182,10 +182,28 @@ See [docs/lmsh.md](docs/lmsh.md) for details.
 
 **Unified session finder** - Search across both Claude Code and Codex sessions simultaneously.
 
-> **⚠️ Note about the `fs` command**: For convenience, this tool is available as both `find-session` and `fs`. The short `fs` alias may conflict with existing commands or aliases in your shell. If you have a conflict, you can:
-> - Use the full `find-session` command instead
-> - Create your own alias: `alias mysearch='find-session'`
-> - Uninstall and reinstall without the `fs` entry point (edit `pyproject.toml`)
+### Setup (Recommended)
+
+Add this function to your shell config (.bashrc/.zshrc) for persistent directory changes:
+
+```bash
+fs() {
+    # Check if user is asking for help
+    if [[ "$1" == "--help" ]] || [[ "$1" == "-h" ]]; then
+        find-session --help
+        return
+    fi
+    # Run find-session in shell mode and evaluate the output
+    eval "$(find-session --shell "$@" | sed '/^$/d')"
+}
+```
+
+Or source the provided function:
+```bash
+source /path/to/claude-code-tools/scripts/fs-function.sh
+```
+
+**Why use the shell wrapper?** When you resume a session from a different directory, the wrapper ensures the directory change persists after the session exits. Without it, you'll be back in your original directory after exiting the session (though the session itself runs in the correct directory).
 
 ### Usage
 
@@ -215,6 +233,7 @@ fs "keywords" -n 15
 - **Multi-agent search**: Searches both Claude Code and Codex sessions simultaneously
 - **Unified display**: Single table showing sessions from all agents with agent column
 - **Smart resume**: Automatically uses correct CLI tool (`claude` or `codex`) based on selected session
+- **Persistent directory changes**: Using the `fs` wrapper ensures you stay in the session's directory after exit
 - **Optional keyword search**: Keywords are optional—omit them to show all sessions
 - **Action menu** after session selection:
   - Resume session (default)
@@ -228,6 +247,8 @@ fs "keywords" -n 15
 - Reverse chronological ordering (most recent first)
 - Press Enter to cancel (no need for Ctrl+C)
 
+Note: You can also use `find-session` directly, but directory changes won't persist after exiting sessions.
+
 ### Configuration (Optional)
 
 Create `~/.config/find-session/config.json` to customize agent settings:
@@ -335,27 +356,48 @@ Search and resume Codex sessions by keywords. Usage is similar to `find-claude-s
 - Extracts metadata from `session_meta` entries in Codex JSONL files
 - Resumes sessions with `codex resume <session-id>`
 
+### Setup (Recommended)
+
+Add this function to your shell config (.bashrc/.zshrc) for persistent directory changes:
+
+```bash
+fcs-codex() {
+    # Check if user is asking for help
+    if [[ "$1" == "--help" ]] || [[ "$1" == "-h" ]]; then
+        find-codex-session --help
+        return
+    fi
+    # Run find-codex-session in shell mode and evaluate the output
+    eval "$(find-codex-session --shell "$@" | sed '/^$/d')"
+}
+```
+
+Or source the provided function:
+```bash
+source /path/to/claude-code-tools/scripts/fcs-codex-function.sh
+```
+
 ### Usage
 
 ```bash
 # Search in current project only (default)
-find-codex-session "keyword1,keyword2"
+fcs-codex "keyword1,keyword2"
 
 # Show all sessions in current project (no keyword filtering)
-find-codex-session
+fcs-codex
 
 # Search across all projects
-find-codex-session "keywords" -g
-find-codex-session "keywords" --global
+fcs-codex "keywords" -g
+fcs-codex "keywords" --global
 
 # Show all sessions across all projects
-find-codex-session -g
+fcs-codex -g
 
 # Limit number of results
-find-codex-session "keywords" -n 5
+fcs-codex "keywords" -n 5
 
 # Custom Codex home directory
-find-codex-session "keywords" --codex-home /custom/path
+fcs-codex "keywords" --codex-home /custom/path
 ```
 
 ### Features
@@ -375,6 +417,8 @@ find-codex-session "keywords" --codex-home /custom/path
 - Multi-line preview wrapping for better readability
 - Press Enter to cancel (no need for Ctrl+C)
 
+Note: You can also use `find-codex-session` directly, but directory changes won't persist after exiting Codex.
+
 Looks like this --
 
 ![find-codex-session.png](demos/find-codex-session.png)

{claude_code_tools-0.2.6 → claude_code_tools-0.2.7}/README.md

@@ -168,10 +168,28 @@ See [docs/lmsh.md](docs/lmsh.md) for details.
 
 **Unified session finder** - Search across both Claude Code and Codex sessions simultaneously.
 
-> **⚠️ Note about the `fs` command**: For convenience, this tool is available as both `find-session` and `fs`. The short `fs` alias may conflict with existing commands or aliases in your shell. If you have a conflict, you can:
-> - Use the full `find-session` command instead
-> - Create your own alias: `alias mysearch='find-session'`
-> - Uninstall and reinstall without the `fs` entry point (edit `pyproject.toml`)
+### Setup (Recommended)
+
+Add this function to your shell config (.bashrc/.zshrc) for persistent directory changes:
+
+```bash
+fs() {
+    # Check if user is asking for help
+    if [[ "$1" == "--help" ]] || [[ "$1" == "-h" ]]; then
+        find-session --help
+        return
+    fi
+    # Run find-session in shell mode and evaluate the output
+    eval "$(find-session --shell "$@" | sed '/^$/d')"
+}
+```
+
+Or source the provided function:
+```bash
+source /path/to/claude-code-tools/scripts/fs-function.sh
+```
+
+**Why use the shell wrapper?** When you resume a session from a different directory, the wrapper ensures the directory change persists after the session exits. Without it, you'll be back in your original directory after exiting the session (though the session itself runs in the correct directory).
 
 ### Usage
 
@@ -201,6 +219,7 @@ fs "keywords" -n 15
 - **Multi-agent search**: Searches both Claude Code and Codex sessions simultaneously
 - **Unified display**: Single table showing sessions from all agents with agent column
 - **Smart resume**: Automatically uses correct CLI tool (`claude` or `codex`) based on selected session
+- **Persistent directory changes**: Using the `fs` wrapper ensures you stay in the session's directory after exit
 - **Optional keyword search**: Keywords are optional—omit them to show all sessions
 - **Action menu** after session selection:
   - Resume session (default)
@@ -214,6 +233,8 @@ fs "keywords" -n 15
 - Reverse chronological ordering (most recent first)
 - Press Enter to cancel (no need for Ctrl+C)
 
+Note: You can also use `find-session` directly, but directory changes won't persist after exiting sessions.
+
 ### Configuration (Optional)
 
 Create `~/.config/find-session/config.json` to customize agent settings:
@@ -321,27 +342,48 @@ Search and resume Codex sessions by keywords. Usage is similar to `find-claude-s
 - Extracts metadata from `session_meta` entries in Codex JSONL files
 - Resumes sessions with `codex resume <session-id>`
 
+### Setup (Recommended)
+
+Add this function to your shell config (.bashrc/.zshrc) for persistent directory changes:
+
+```bash
+fcs-codex() {
+    # Check if user is asking for help
+    if [[ "$1" == "--help" ]] || [[ "$1" == "-h" ]]; then
+        find-codex-session --help
+        return
+    fi
+    # Run find-codex-session in shell mode and evaluate the output
+    eval "$(find-codex-session --shell "$@" | sed '/^$/d')"
+}
+```
+
+Or source the provided function:
+```bash
+source /path/to/claude-code-tools/scripts/fcs-codex-function.sh
+```
+
 ### Usage
 
 ```bash
 # Search in current project only (default)
-find-codex-session "keyword1,keyword2"
+fcs-codex "keyword1,keyword2"
 
 # Show all sessions in current project (no keyword filtering)
-find-codex-session
+fcs-codex
 
 # Search across all projects
-find-codex-session "keywords" -g
-find-codex-session "keywords" --global
+fcs-codex "keywords" -g
+fcs-codex "keywords" --global
 
 # Show all sessions across all projects
-find-codex-session -g
+fcs-codex -g
 
 # Limit number of results
-find-codex-session "keywords" -n 5
+fcs-codex "keywords" -n 5
 
 # Custom Codex home directory
-find-codex-session "keywords" --codex-home /custom/path
+fcs-codex "keywords" --codex-home /custom/path
 ```
 
 ### Features
@@ -361,6 +403,8 @@ find-codex-session "keywords" --codex-home /custom/path
 - Multi-line preview wrapping for better readability
 - Press Enter to cancel (no need for Ctrl+C)
 
+Note: You can also use `find-codex-session` directly, but directory changes won't persist after exiting Codex.
+
 Looks like this --
 
 ![find-codex-session.png](demos/find-codex-session.png)

{claude_code_tools-0.2.6 → claude_code_tools-0.2.7}/claude_code_tools/__init__.py

@@ -1,3 +1,3 @@
 """Claude Code Tools - Collection of utilities for Claude Code."""
 
-__version__ = "0.2.6"
+__version__ = "0.2.7"

{claude_code_tools-0.2.6 → claude_code_tools-0.2.7}/claude_code_tools/find_session.py

@@ -262,21 +262,30 @@ def display_interactive_ui(
             ui_console.print("[red]Invalid choice. Please try again.[/red]")
 
 
-def show_action_menu(session: dict) -> Optional[str]:
+def show_action_menu(session: dict, stderr_mode: bool = False) -> Optional[str]:
     """Show action menu for selected session."""
-    print(f"\n=== Session: {session['session_id'][:16]}... ===")
-    print(f"Agent: {session['agent_display']}")
-    print(f"Project: {session['project']}")
+    output = sys.stderr if stderr_mode else sys.stdout
+
+    print(f"\n=== Session: {session['session_id'][:16]}... ===", file=output)
+    print(f"Agent: {session['agent_display']}", file=output)
+    print(f"Project: {session['project']}", file=output)
     if session.get("branch"):
-        print(f"Branch: {session['branch']}")
-    print(f"\nWhat would you like to do?")
-    print("1. Resume session (default)")
-    print("2. Show session file path")
-    print("3. Copy session file to file (*.jsonl) or directory")
-    print()
+        print(f"Branch: {session['branch']}", file=output)
+    print(f"\nWhat would you like to do?", file=output)
+    print("1. Resume session (default)", file=output)
+    print("2. Show session file path", file=output)
+    print("3. Copy session file to file (*.jsonl) or directory", file=output)
+    print(file=output)
 
     try:
-        choice = input("Enter choice [1-3] (or Enter for 1): ").strip()
+        if stderr_mode:
+            # In stderr mode, prompt to stderr so it's visible
+            sys.stderr.write("Enter choice [1-3] (or Enter for 1): ")
+            sys.stderr.flush()
+            choice = sys.stdin.readline().strip()
+        else:
+            choice = input("Enter choice [1-3] (or Enter for 1): ").strip()
+
         if not choice or choice == "1":
             return "resume"
         elif choice == "2":
@@ -284,10 +293,10 @@ def show_action_menu(session: dict) -> Optional[str]:
         elif choice == "3":
             return "copy"
         else:
-            print("Invalid choice.")
+            print("Invalid choice.", file=output)
             return None
     except KeyboardInterrupt:
-        print("\nCancelled.")
+        print("\nCancelled.", file=output)
         return None
 
 
@@ -421,7 +430,7 @@ Examples:
         )
         if selected_session:
             # Show action menu
-            action = show_action_menu(selected_session)
+            action = show_action_menu(selected_session, stderr_mode=args.shell)
             if action:
                 handle_action(selected_session, action, shell_mode=args.shell)
     else:

{claude_code_tools-0.2.6 → claude_code_tools-0.2.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "claude-code-tools"
-version = "0.2.6"
+version = "0.2.7"
 description = "Collection of tools for working with Claude Code"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -18,7 +18,6 @@ dev = ["commitizen>=3.0.0"]
 find-claude-session = "claude_code_tools.find_claude_session:main"
 find-codex-session = "claude_code_tools.find_codex_session:main"
 find-session = "claude_code_tools.find_session:main"
-fs = "claude_code_tools.find_session:main"
 vault = "claude_code_tools.dotenv_vault:main"
 tmux-cli = "claude_code_tools.tmux_cli_controller:main"
 env-safe = "claude_code_tools.env_safe:main"
@@ -45,7 +44,7 @@ exclude = [
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "0.2.6"
+version = "0.2.7"
 tag_format = "v$version"
 version_files = [
     "pyproject.toml:version",