aweshelf 0.1.1__tar.gz

aweshelf-0.1.1/PKG-INFO

@@ -0,0 +1,108 @@
+Metadata-Version: 2.4
+Name: aweshelf
+Version: 0.1.1
+Summary: Bookmark, categorize, and restore AI coding sessions with aweswitch profiles.
+Author: Peng
+License-Expression: MPL-2.0
+Keywords: ai,agent,claude,codex,bookmark,session,aweswitch
+Classifier: Development Status :: 3 - Alpha
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: click>=8.1
+Requires-Dist: textual>=0.40
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: ruff; extra == "dev"
+
+<div align="center">
+  <h1>aweshelf: Session Bookmark Manager</h1>
+  <p><strong>Bookmark, categorize, and restore AI coding sessions with aweswitch profiles.</strong></p>
+  <p>A lightweight CLI-first tool for Claude Code and Codex session management.</p>
+  <p>
+    <strong>English</strong> ·
+    <a href="./README_cn.md">简体中文</a>
+  </p>
+  <p>
+    <img src="https://img.shields.io/badge/version-0.1.1-7C3AED?style=flat-square" alt="Version">
+    <img src="https://img.shields.io/badge/python-%E2%89%A53.10-0EA5E9?style=flat-square" alt="Python">
+  </p>
+  <p>
+    <img src="https://img.shields.io/badge/status-alpha-c96a3d?style=flat-square" alt="Status">
+    <img src="https://img.shields.io/badge/install-pip-22C55E?style=flat-square" alt="pip install">
+    <img src="https://img.shields.io/badge/platform-terminal-334155?style=flat-square" alt="Platform">
+    <img src="https://img.shields.io/github/stars/Webioinfo01/aweshelf?style=flat-square" alt="GitHub stars">
+  </p>
+</div>
+
+> Bookmark, categorize, and restore AI coding sessions with aweswitch profiles.
+
+aweshelf lets you save your favorite Claude Code and Codex sessions, tag them with categories, and restore them instantly — including the aweswitch profile (API endpoint, model, token) that was active when you bookmarked.
+
+## Install
+
+```bash
+pip install aweshelf
+```
+
+## Quick Start
+
+```bash
+# Bookmark the current project's most recent session
+aweshelf bookmark
+
+# List all bookmarks
+aweshelf list
+
+# Resume a bookmark
+aweshelf resume aweshelf_0001
+
+# Browse interactively
+aweshelf browse
+```
+
+## Config
+
+Bookmarks are stored at `~/.config/aweshelf/bookmarks.json`. Override with `AWESHELF_CONFIG` env var.
+
+```json
+{
+  "version": 1,
+  "bookmarks": [
+    {
+      "id": "aweshelf_0001",
+      "provider": "claude",
+      "session_id": "550e8400-...",
+      "title": "Fix auth middleware bug",
+      "category": "backend",
+      "project_path": "/Users/peng/Desktop/Project/my-app",
+      "aweswitch_profile": "cc-glm",
+      "bookmarked_at": "2026-05-20T14:00:00Z"
+    }
+  ]
+}
+```
+
+## Commands
+
+```bash
+aweshelf bookmark [SESSION_ID] [-t TITLE] [-c CATEGORY] [--profile PROFILE]
+aweshelf list [-c CATEGORY] [-p PROVIDER]
+aweshelf search QUERY
+aweshelf recent [-n COUNT]
+aweshelf show BOOKMARK_ID [--json]
+aweshelf edit BOOKMARK_ID [-t TITLE] [-c CATEGORY] [--profile PROFILE]
+aweshelf rm BOOKMARK_ID [--force]
+aweshelf resume BOOKMARK_ID [--profile PROFILE] [--raw] [--dry-run]
+aweshelf browse
+```
+
+## Development
+
+```bash
+python -m pytest tests/
+```

aweshelf-0.1.1/README.md

@@ -0,0 +1,87 @@
+<div align="center">
+  <h1>aweshelf: Session Bookmark Manager</h1>
+  <p><strong>Bookmark, categorize, and restore AI coding sessions with aweswitch profiles.</strong></p>
+  <p>A lightweight CLI-first tool for Claude Code and Codex session management.</p>
+  <p>
+    <strong>English</strong> ·
+    <a href="./README_cn.md">简体中文</a>
+  </p>
+  <p>
+    <img src="https://img.shields.io/badge/version-0.1.1-7C3AED?style=flat-square" alt="Version">
+    <img src="https://img.shields.io/badge/python-%E2%89%A53.10-0EA5E9?style=flat-square" alt="Python">
+  </p>
+  <p>
+    <img src="https://img.shields.io/badge/status-alpha-c96a3d?style=flat-square" alt="Status">
+    <img src="https://img.shields.io/badge/install-pip-22C55E?style=flat-square" alt="pip install">
+    <img src="https://img.shields.io/badge/platform-terminal-334155?style=flat-square" alt="Platform">
+    <img src="https://img.shields.io/github/stars/Webioinfo01/aweshelf?style=flat-square" alt="GitHub stars">
+  </p>
+</div>
+
+> Bookmark, categorize, and restore AI coding sessions with aweswitch profiles.
+
+aweshelf lets you save your favorite Claude Code and Codex sessions, tag them with categories, and restore them instantly — including the aweswitch profile (API endpoint, model, token) that was active when you bookmarked.
+
+## Install
+
+```bash
+pip install aweshelf
+```
+
+## Quick Start
+
+```bash
+# Bookmark the current project's most recent session
+aweshelf bookmark
+
+# List all bookmarks
+aweshelf list
+
+# Resume a bookmark
+aweshelf resume aweshelf_0001
+
+# Browse interactively
+aweshelf browse
+```
+
+## Config
+
+Bookmarks are stored at `~/.config/aweshelf/bookmarks.json`. Override with `AWESHELF_CONFIG` env var.
+
+```json
+{
+  "version": 1,
+  "bookmarks": [
+    {
+      "id": "aweshelf_0001",
+      "provider": "claude",
+      "session_id": "550e8400-...",
+      "title": "Fix auth middleware bug",
+      "category": "backend",
+      "project_path": "/Users/peng/Desktop/Project/my-app",
+      "aweswitch_profile": "cc-glm",
+      "bookmarked_at": "2026-05-20T14:00:00Z"
+    }
+  ]
+}
+```
+
+## Commands
+
+```bash
+aweshelf bookmark [SESSION_ID] [-t TITLE] [-c CATEGORY] [--profile PROFILE]
+aweshelf list [-c CATEGORY] [-p PROVIDER]
+aweshelf search QUERY
+aweshelf recent [-n COUNT]
+aweshelf show BOOKMARK_ID [--json]
+aweshelf edit BOOKMARK_ID [-t TITLE] [-c CATEGORY] [--profile PROFILE]
+aweshelf rm BOOKMARK_ID [--force]
+aweshelf resume BOOKMARK_ID [--profile PROFILE] [--raw] [--dry-run]
+aweshelf browse
+```
+
+## Development
+
+```bash
+python -m pytest tests/
+```

aweshelf-0.1.1/pyproject.toml

@@ -0,0 +1,47 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "aweshelf"
+version = "0.1.1"
+description = "Bookmark, categorize, and restore AI coding sessions with aweswitch profiles."
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = ["click>=8.1", "textual>=0.40"]
+authors = [
+  { name = "Peng" }
+]
+license = "MPL-2.0"
+keywords = ["ai", "agent", "claude", "codex", "bookmark", "session", "aweswitch"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Environment :: Console",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3 :: Only",
+  "Topic :: Utilities"
+]
+
+[project.optional-dependencies]
+dev = ["pytest", "ruff"]
+
+[project.scripts]
+aweshelf = "aweshelf.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.ruff]
+target-version = "py310"
+line-length = 100
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "UP", "B", "SIM"]
+ignore = ["E501"]
+
+[tool.ruff.lint.isort]
+known-first-party = ["aweshelf"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]

aweshelf-0.1.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

aweshelf-0.1.1/src/aweshelf/__init__.py

@@ -0,0 +1,3 @@
+"""aweshelf package."""
+
+__version__ = "0.1.1"

aweshelf-0.1.1/src/aweshelf/cli.py

@@ -0,0 +1,55 @@
+"""aweshelf CLI entry point."""
+
+import click
+
+from aweshelf import __version__
+from aweshelf.commands.bookmark import bookmark_command
+from aweshelf.commands.list import list_command, search_command, recent_command
+from aweshelf.commands.show import show_command, edit_command, rm_command
+from aweshelf.commands.resume import resume_command
+from aweshelf.commands.browse import browse_command
+
+
+@click.group(
+    name="aweshelf",
+    context_settings={"help_option_names": ["-h", "--help"]},
+    help="Bookmark, categorize, and restore AI coding sessions.",
+)
+@click.version_option(__version__, "-v", "--version", message="%(version)s")
+def cli():
+    pass
+
+
+cli.add_command(bookmark_command)
+cli.add_command(list_command)
+cli.add_command(search_command)
+cli.add_command(recent_command)
+cli.add_command(show_command)
+cli.add_command(edit_command)
+cli.add_command(rm_command)
+cli.add_command(resume_command)
+cli.add_command(browse_command)
+
+
+@cli.command("help")
+@click.argument("command_name", required=False)
+@click.pass_context
+def help_command(ctx, command_name):
+    """Display help for command."""
+    if command_name is None:
+        click.echo(ctx.parent.get_help())
+        return
+
+    command = cli.get_command(ctx, command_name)
+    if command is None or command.hidden:
+        raise click.ClickException(f"unknown command '{command_name}'")
+    with command.make_context(command_name, [], parent=ctx.parent, resilient_parsing=True) as command_ctx:
+        click.echo(command.get_help(command_ctx))
+
+
+def main(argv=None):
+    return cli.main(args=argv, prog_name="aweshelf")
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

aweshelf-0.1.1/src/aweshelf/commands/bookmark.py

@@ -0,0 +1,127 @@
+"""Bookmark command."""
+
+import click
+
+from aweshelf.types import Bookmark
+from aweshelf.lib.store import add_bookmark, list_categories, bookmark_path
+from aweshelf.lib.discovery import find_project_sessions, find_recent_session
+from aweshelf.lib.session import parse_session_meta
+from aweshelf.lib.aweswitch import detect_profile, load_aweswitch_config
+
+DEFAULT_LIST_LIMIT = 10
+
+
+def pick_session(sessions: list[dict], limit: int = DEFAULT_LIST_LIMIT) -> dict:
+    """Let user pick a session from a numbered list."""
+    shown = sessions[:limit]
+    total = len(sessions)
+
+    if total > limit:
+        click.echo(f"Sessions in current project ({total} total, showing {limit} \u2014 use --verbose for all):\n")
+    else:
+        click.echo(f"Sessions in current project ({total} total):\n")
+
+    for i, s in enumerate(shown, 1):
+        title = s.get("title", "Untitled")
+        provider = s.get("provider", "?")
+        sid = s.get("session_id", "?")
+        click.echo(f"  {i:>3}. [{provider}] {title}")
+        click.echo(f"       {sid}")
+
+    if total > limit:
+        click.echo(f"\n  ... and {total - limit} more")
+    click.echo()
+
+    while True:
+        choice = click.prompt("Pick a session (number)", type=int)
+        if 1 <= choice <= len(shown):
+            return sessions[choice - 1]
+        click.echo(f"Please enter 1-{len(shown)}")
+
+
+def run_bookmark(
+    session_id: str | None = None,
+    title: str | None = None,
+    category: str | None = None,
+    profile: str | None = None,
+    interactive: bool = True,
+    verbose: bool = False,
+) -> Bookmark:
+    path = bookmark_path()
+
+    if session_id is None and interactive:
+        sessions = find_project_sessions()
+        if not sessions:
+            raise SystemExit("aweshelf: no session found in current project")
+        limit = len(sessions) if verbose else DEFAULT_LIST_LIMIT
+        session = pick_session(sessions, limit)
+        session_id = session["session_id"]
+        source_path = session.get("source_path", "")
+        provider = session.get("provider", "claude")
+        auto_title = session.get("title", "")
+        project_path = session.get("project_path", "")
+    elif session_id is None:
+        session = find_recent_session()
+        if session is None:
+            raise SystemExit("aweshelf: no session found in current project")
+        session_id = session["session_id"]
+        source_path = session.get("source_path", "")
+        provider = session.get("provider", "claude")
+        auto_title = session.get("title", "")
+        project_path = session.get("project_path", "")
+    else:
+        source_path = ""
+        provider = "claude"
+        auto_title = ""
+        project_path = ""
+
+    if title is None:
+        title = auto_title or "Untitled session"
+
+    if interactive and category is None:
+        cats = list_categories(path)
+        click.echo(f"\nTitle: {title}")
+        if cats:
+            click.echo(f"Existing categories: {', '.join(cats)}")
+        cat_input = click.prompt("Category", default="", show_default=False)
+        category = cat_input if cat_input else ""
+
+    if category is None:
+        category = ""
+
+    if profile is None and source_path:
+        try:
+            meta = parse_session_meta(source_path)
+            config = load_aweswitch_config()
+            if config:
+                profile = detect_profile({"ANTHROPIC_BASE_URL": "", "ANTHROPIC_MODEL": meta.get("model", "")})
+        except Exception:
+            pass
+
+    bookmark = Bookmark(
+        id="",
+        provider=provider,
+        session_id=session_id,
+        title=title,
+        category=category,
+        project_path=project_path,
+        aweswitch_profile=profile,
+    )
+
+    bookmark = add_bookmark(bookmark, path)
+    return bookmark
+
+
+@click.command("bookmark")
+@click.argument("session_id", required=False)
+@click.option("-t", "--title", default=None, help="Bookmark title.")
+@click.option("-c", "--category", default=None, help="Category for the bookmark.")
+@click.option("--profile", default=None, help="aweswitch profile to use.")
+@click.option("--verbose", is_flag=True, help="Show all sessions (no limit).")
+def bookmark_command(session_id, title, category, profile, verbose):
+    """Bookmark a session for quick access."""
+    try:
+        b = run_bookmark(session_id, title, category, profile, interactive=True, verbose=verbose)
+    except ValueError as exc:
+        raise click.ClickException(str(exc)) from exc
+    click.echo(f"\nBookmarked {b.id} — {b.title}")

aweshelf-0.1.1/src/aweshelf/commands/browse.py

@@ -0,0 +1,20 @@
+"""Browse command — TUI entry point."""
+
+import click
+
+from aweshelf.lib.resume_target import execute_resume
+
+
+@click.command("browse")
+def browse_command():
+    """Browse bookmarks interactively."""
+    try:
+        from aweshelf.tui.app import BookmarkBrowser
+    except ImportError as exc:
+        raise click.ClickException("textual is required for browse. Install with: pip install textual") from exc
+
+    app = BookmarkBrowser()
+    result = app.run()
+
+    if result is not None:
+        execute_resume(result)

aweshelf-0.1.1/src/aweshelf/commands/list.py

@@ -0,0 +1,75 @@
+"""List, search, recent commands."""
+
+import click
+
+from aweshelf.lib.store import load_bookmarks
+
+
+def format_table(bookmarks: list) -> str:
+    if not bookmarks:
+        return "No bookmarks found."
+
+    headers = ["ID", "PROVIDER", "TITLE", "CATEGORY", "PROFILE"]
+    rows = []
+    for b in bookmarks:
+        rows.append([
+            b.id,
+            b.provider,
+            b.title[:40] + ("..." if len(b.title) > 40 else ""),
+            b.category or "-",
+            b.aweswitch_profile or "-",
+        ])
+
+    widths = [len(h) for h in headers]
+    for row in rows:
+        for i, cell in enumerate(row):
+            widths[i] = max(widths[i], len(cell))
+
+    lines = []
+    header_line = "  ".join(h.ljust(widths[i]) for i, h in enumerate(headers))
+    lines.append(header_line)
+    lines.append("  ".join("-" * w for w in widths))
+    for row in rows:
+        line = "  ".join(cell.ljust(widths[i]) for i, cell in enumerate(row))
+        lines.append(line)
+
+    return "\n".join(lines)
+
+
+@click.command("list")
+@click.option("-c", "--category", default=None, help="Filter by category.")
+@click.option("-p", "--provider", default=None, help="Filter by provider.")
+def list_command(category, provider):
+    """List all bookmarks."""
+    bookmarks = load_bookmarks()
+    if category:
+        bookmarks = [b for b in bookmarks if b.category == category]
+    if provider:
+        bookmarks = [b for b in bookmarks if b.provider == provider]
+    click.echo(format_table(bookmarks))
+
+
+@click.command("search")
+@click.argument("query")
+def search_command(query):
+    """Search bookmarks by title, category, session ID, project, or profile."""
+    bookmarks = load_bookmarks()
+    query_lower = query.lower()
+    results = [
+        b for b in bookmarks
+        if query_lower in b.title.lower()
+        or query_lower in b.category.lower()
+        or query_lower in b.session_id.lower()
+        or query_lower in b.project_path.lower()
+        or (b.aweswitch_profile and query_lower in b.aweswitch_profile.lower())
+    ]
+    click.echo(format_table(results))
+
+
+@click.command("recent")
+@click.option("-n", "--count", default=10, help="Number of recent bookmarks.")
+def recent_command(count):
+    """Show recently bookmarked sessions."""
+    bookmarks = load_bookmarks()
+    bookmarks.sort(key=lambda b: b.bookmarked_at, reverse=True)
+    click.echo(format_table(bookmarks[:count]))

aweshelf-0.1.1/src/aweshelf/commands/resume.py

@@ -0,0 +1,42 @@
+"""Resume command."""
+
+import click
+
+from aweshelf.lib.resume_target import (
+    ResumeError,
+    build_resume_target,
+    format_resume_target,
+    run_resume_target,
+)
+from aweshelf.lib.store import find_bookmark
+
+
+@click.command("resume")
+@click.argument("bookmark_id")
+@click.option("--profile", default=None, help="Override aweswitch profile.")
+@click.option("--raw", is_flag=True, help="Skip aweswitch, use claude/codex directly.")
+@click.option("--dry-run", is_flag=True, help="Print the resume command without running it.")
+def resume_command(bookmark_id, profile, raw, dry_run):
+    """Resume a bookmarked session."""
+    b = find_bookmark(bookmark_id)
+    if b is None:
+        raise click.ClickException(f"bookmark not found: {bookmark_id}")
+
+    try:
+        target = build_resume_target(b, profile_override=profile, raw=raw)
+    except ResumeError as exc:
+        raise click.ClickException(str(exc)) from exc
+    if target.warning:
+        click.echo(f"Warning: {target.warning}", err=True)
+    click.echo(f"Resuming {b.id} — {b.title}")
+    click.echo(f"  $ {format_resume_target(target)}")
+
+    if dry_run:
+        return
+
+    try:
+        run_resume_target(target)
+    except FileNotFoundError as exc:
+        raise click.ClickException(f"command not found: {target.argv[0]}") from exc
+    except OSError as exc:
+        raise click.ClickException(f"failed to run {target.argv[0]}: {exc}") from exc

aweshelf-0.1.1/src/aweshelf/commands/show.py

@@ -0,0 +1,68 @@
+"""Show, edit, rm commands."""
+
+import json
+
+import click
+
+from aweshelf.lib.store import find_bookmark, update_bookmark, remove_bookmark
+
+
+@click.command("show")
+@click.argument("bookmark_id")
+@click.option("--json", "as_json", is_flag=True, help="Output as raw JSON.")
+def show_command(bookmark_id, as_json):
+    """Show bookmark details."""
+    b = find_bookmark(bookmark_id)
+    if b is None:
+        raise click.ClickException(f"bookmark not found: {bookmark_id}")
+    if as_json:
+        click.echo(json.dumps(b.to_dict(), indent=2, ensure_ascii=False))
+    else:
+        click.echo(f"ID:               {b.id}")
+        click.echo(f"Provider:         {b.provider}")
+        click.echo(f"Session ID:       {b.session_id}")
+        click.echo(f"Title:            {b.title}")
+        click.echo(f"Category:         {b.category or '-'}")
+        click.echo(f"Project:          {b.project_path or '-'}")
+        click.echo(f"aweswitch Profile: {b.aweswitch_profile or '-'}")
+        click.echo(f"Bookmarked at:    {b.bookmarked_at}")
+
+
+@click.command("edit")
+@click.argument("bookmark_id")
+@click.option("-t", "--title", default=None, help="New title.")
+@click.option("-c", "--category", default=None, help="New category.")
+@click.option("--profile", default=None, help="New aweswitch profile.")
+def edit_command(bookmark_id, title, category, profile):
+    """Edit a bookmark's metadata."""
+    fields = {}
+    if title is not None:
+        fields["title"] = title
+    if category is not None:
+        fields["category"] = category
+    if profile is not None:
+        fields["aweswitch_profile"] = profile
+
+    if not fields:
+        raise click.ClickException("nothing to edit; use -t, -c, or --profile")
+
+    b = update_bookmark(bookmark_id, **fields)
+    if b is None:
+        raise click.ClickException(f"bookmark not found: {bookmark_id}")
+    click.echo(f"Updated {b.id}")
+
+
+@click.command("rm")
+@click.argument("bookmark_id")
+@click.option("--force", is_flag=True, help="Skip confirmation.")
+def rm_command(bookmark_id, force):
+    """Remove a bookmark."""
+    b = find_bookmark(bookmark_id)
+    if b is None:
+        raise click.ClickException(f"bookmark not found: {bookmark_id}")
+
+    if not force:
+        click.confirm(f"Remove bookmark {b.id} ({b.title})?", abort=True)
+
+    remove_bookmark(bookmark_id)
+    click.echo(f"Removed {bookmark_id}")