ccmd 2.0.6__tar.gz → 2.0.8__tar.gz

{ccmd-2.0.6/ccmd.egg-info → ccmd-2.0.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccmd
-Version: 2.0.6
+Version: 2.0.8
 Summary: ccmd — Agentic Project Hub. Pick a project, pick an agent, launch.
 Author-email: De Catalyst <Robert5560newton@gmail.com>
 License: MIT

{ccmd-2.0.6 → ccmd-2.0.8}/ccmd/__init__.py

@@ -1,4 +1,4 @@
 """ccmd 2.0 — Agentic Project Hub."""
 
-__version__ = "2.0.6"
+__version__ = "2.0.8"
 __all__ = ["__version__"]

{ccmd-2.0.6 → ccmd-2.0.8}/ccmd/cli.py

@@ -20,55 +20,84 @@ from ccmd.core.sessions import SessionStore
 from ccmd.core.ssh import SSHStore
 
 
+def _print_cmd_rows(rows: list, *, verbose: bool = False) -> None:
+    if not rows:
+        print("no matching commands")
+        return
+    for r in rows:
+        v = r["variants"]
+        print(
+            f"{r['short']:<10} {r['project']:<20} "
+            f"default={r['default_agent']:<8}  "
+            f"{v.get('claude',''):<10} {v.get('grok',''):<10} "
+            f"{v.get('codex',''):<10} {v.get('cursor',''):<10}"
+        )
+        if verbose or len(rows) == 1:
+            print(f"{'':10} path  {r['path']}")
+            print(
+                f"{'':10} all   "
+                + "  ".join(f"{aid}={fn}" for aid, fn in v.items())
+            )
+    print(f"\n{len(rows)} project(s)  ·  helper: ccmds   ·  file: use ccmd shell list")
+
+
 def _cmd_shell(args: argparse.Namespace) -> int:
     from ccmd.core.shell_cmds import (
+        format_cmds_block,
         install_shell_hook,
         list_cmd_rows,
         shell_cmds_path,
         write_shell_cmds,
     )
 
-    sub = args.shell_cmd or "regen"
+    sub = args.shell_cmd or "list"
+    filt = getattr(args, "filter", None)
+    verbose = bool(getattr(args, "verbose", False))
+
     if sub == "install":
-        path = write_shell_cmds()
+        path, shorts = write_shell_cmds()
         rcs = install_shell_hook()
         print(f"wrote {path}")
         for rc in rcs:
             print(f"hooked {rc}")
         print("restart shell or:  source ~/.ccmd/shell_cmds.sh")
-        print("then:  ana / anac / anag  …")
+        print("then:  ccmds          # list all")
+        print("       ana / anac / anag  …")
+        if verbose:
+            _print_cmd_rows(list_cmd_rows(), verbose=False)
         return 0
     if sub == "regen":
-        path = write_shell_cmds()
-        print(f"regenerated {path}")
-        rows = list_cmd_rows()
-        for r in rows[:30]:
-            print(
-                f"  {r['short']:<10} {r['project']:<18} "
-                f"default={r['default_agent']:<8}  "
-                f"{r['short']}c/g/x/u/o/a/p"
-            )
-        if len(rows) > 30:
-            print(f"  … +{len(rows) - 30} more  (see {path})")
+        path, shorts = write_shell_cmds()
+        print(f"regenerated {path}  ({len(shorts)} projects)")
+        rows = list_cmd_rows(filter_text=filt)
+        _print_cmd_rows(rows, verbose=verbose)
         return 0
     if sub == "list":
-        for r in list_cmd_rows():
-            vars_ = " ".join(
-                f"{k[0]}={v}" for k, v in r["variants"].items()
-            )
-            # show compact
-            v = r["variants"]
-            print(
-                f"{r['short']:<10} {r['project']:<20} "
-                f"{v.get('claude','')} {v.get('grok','')} {v.get('codex','')} "
-                f"{v.get('cursor','')}  → {r['path']}"
-            )
-        print(f"\nfile: {shell_cmds_path()}")
+        rows = list_cmd_rows(filter_text=filt)
+        _print_cmd_rows(rows, verbose=verbose or bool(filt))
+        print(f"file: {shell_cmds_path()}")
+        return 0
+    if sub == "show" and filt:
+        rows = list_cmd_rows(filter_text=filt)
+        _print_cmd_rows(rows, verbose=True)
         return 0
-    print("usage: ccmd shell install|regen|list", file=sys.stderr)
+    print("usage: ccmd shell install|regen|list [--filter NAME] [-v]", file=sys.stderr)
+    print("       ccmds              # shell helper (after: source ~/.ccmd/shell_cmds.sh)", file=sys.stderr)
     return 1
 
 
+def _cmd_cmds(args: argparse.Namespace) -> int:
+    """Top-level: ccmd cmds [--list] [filter]  — same as shell list."""
+    from ccmd.core.shell_cmds import list_cmd_rows, shell_cmds_path
+
+    filt = args.filter or args.name
+    rows = list_cmd_rows(filter_text=filt)
+    _print_cmd_rows(rows, verbose=bool(filt) or args.verbose)
+    print(f"file: {shell_cmds_path()}")
+    print("tip:  ccmds   (shell function) after source ~/.ccmd/shell_cmds.sh")
+    return 0
+
+
 def _cmd_open(args: argparse.Namespace) -> int:
     reg = ProjectRegistry()
     project = reg.get(args.project)
@@ -301,9 +330,35 @@ def build_parser() -> argparse.ArgumentParser:
     sh.add_argument(
         "shell_cmd",
         nargs="?",
-        choices=["install", "regen", "list"],
-        default="regen",
-        help="install=write cmds + hook bashrc; regen=rewrite cmds; list=show",
+        choices=["install", "regen", "list", "show"],
+        default="list",
+        help="install|regen|list|show",
+    )
+    sh.add_argument(
+        "--filter",
+        "-f",
+        dest="filter",
+        help="filter by short/project/path (e.g. ana)",
+    )
+    sh.add_argument(
+        "-v",
+        "--verbose",
+        action="store_true",
+        help="show full agent variant map",
+    )
+
+    cmds = sub.add_parser(
+        "cmds",
+        help="List short shell commands (same as: ccmd shell list / ccmds)",
+    )
+    cmds.add_argument("name", nargs="?", help="filter (e.g. ana or flow)")
+    cmds.add_argument("--filter", "-f", dest="filter", help="filter text")
+    cmds.add_argument("-v", "--verbose", action="store_true")
+    cmds.add_argument(
+        "--list",
+        "-l",
+        action="store_true",
+        help="list all (default)",
     )
 
     return p
@@ -336,6 +391,7 @@ def main(argv: list[str] | None = None) -> int:
         "doctor": _cmd_doctor,
         "mcp": _cmd_mcp,
         "shell": _cmd_shell,
+        "cmds": _cmd_cmds,
     }
     handler = handlers.get(args.cmd)
     if not handler:

{ccmd-2.0.6 → ccmd-2.0.8}/ccmd/core/shell_cmds.py

@@ -128,26 +128,31 @@ def shell_cmds_path() -> Path:
 
 
 def short_candidates(project_id: str, name: str) -> list[str]:
-    """Generate preferred short-name candidates for a project."""
+    """Generate preferred short-name candidates for a project.
+
+    Prefer snappy 3–4 letter names (ana, flo) before the full slug.
+    """
     raw = re.sub(r"[^a-z0-9]+", "", (project_id or name).lower())
     if not raw:
         raw = "proj"
     cands: list[str] = []
-    # full slug if short enough
-    if 2 <= len(raw) <= 12:
-        cands.append(raw)
-    # progressive prefixes: ana, anas, anast…
-    for n in range(3, min(8, len(raw) + 1)):
-        cands.append(raw[:n])
+    # progressive prefixes first: ana, anas, anast… (user wants ana not anastasis)
+    for n in (3, 4, 5, 6, 7, 8):
+        if n <= len(raw):
+            cands.append(raw[:n])
+    # first letters of hyphen/underscore parts (build-your-own → byo)
+    parts = re.split(r"[-_\s]+", project_id or name)
+    initials = "".join(p[0] for p in parts if p)[:6].lower()
+    initials = re.sub(r"[^a-z0-9]", "", initials)
+    if len(initials) >= 2:
+        cands.append(initials)
     # consonants-only compact form
     cons = re.sub(r"[aeiou]", "", raw)
     if len(cons) >= 3:
         cands.append(cons[:4])
-    # first letters of hyphen/underscore parts
-    parts = re.split(r"[-_\s]+", project_id or name)
-    initials = "".join(p[0] for p in parts if p)[:6].lower()
-    if len(initials) >= 2:
-        cands.append(re.sub(r"[^a-z0-9]", "", initials))
+    # full slug last (only if reasonably short)
+    if 2 <= len(raw) <= 10:
+        cands.append(raw)
     # dedupe preserve order
     seen: set[str] = set()
     out: list[str] = []
@@ -238,13 +243,66 @@ def render_shell_cmds(projects: list, shorts: dict[str, str]) -> str:
             )
         lines.append("")
 
-    lines.append("# end ccmd shell cmds")
-    lines.append("")
+    # helper: list all short commands from the shell
+    lines.extend(
+        [
+            "# list every project short command",
+            "ccmds() {",
+            '  if [ "$1" = "-h" ] || [ "$1" = "--help" ]; then',
+            '    echo "ccmds              list all short commands"',
+            '    echo "ccmds <name>       show one project (e.g. ccmds ana)"',
+            '    echo "ccmds -l|--list    same as bare ccmds"',
+            '    echo "ccmd shell list    full CLI list"',
+            "    return 0",
+            "  fi",
+            '  if [ -z "$1" ] || [ "$1" = "-l" ] || [ "$1" = "--list" ]; then',
+            '    command ccmd shell list',
+            "    return $?",
+            "  fi",
+            '  command ccmd shell list --filter "$1"',
+            "}",
+            "",
+            "# end ccmd shell cmds",
+            "",
+        ]
+    )
+    return "\n".join(lines)
+
+
+def cmds_notice(project, short: str | None = None) -> str:
+    """Human-readable one-liner of shortcuts for a project (for TUI/CLI notices)."""
+    s = short or getattr(project, "short", None) or ""
+    if not s:
+        shorts = allocate_shorts([project])
+        s = shorts.get(project.id, project.id[:4])
+    variants = " ".join(
+        f"{s}{suf}={aid}" for aid, suf in AGENT_SUFFIX.items()
+    )
+    return (
+        f"cmds: {s} (default={project.default_agent})  "
+        f"{s}c=claude {s}g=grok {s}x=codex {s}u=cursor  "
+        f"| ccmds  or  ccmd shell list"
+    )
+
+
+def format_cmds_block(project, short: str | None = None) -> str:
+    """Multi-line block shown after save."""
+    s = short or getattr(project, "short", None) or project.id[:4]
+    lines = [
+        f"shell commands for {project.id}:",
+        f"  {s:<10} open with default agent ({project.default_agent})",
+    ]
+    for aid, suf in AGENT_SUFFIX.items():
+        lines.append(f"  {s}{suf:<9} --agent {aid}")
+    lines.append("list all:  ccmds   or   ccmd shell list")
     return "\n".join(lines)
 
 
-def write_shell_cmds(projects: list | None = None) -> Path:
-    """Write ~/.ccmd/shell_cmds.sh and persist short names on projects."""
+def write_shell_cmds(projects: list | None = None) -> tuple[Path, dict[str, str]]:
+    """Write ~/.ccmd/shell_cmds.sh and persist short names on projects.
+
+    Returns (path, {project_id: short}).
+    """
     from ccmd.core.projects import ProjectRegistry
 
     reg = ProjectRegistry()
@@ -273,7 +331,7 @@ def write_shell_cmds(projects: list | None = None) -> Path:
         )
         lines.append(f"{'':10} {p.path}\n")
     sheet.write_text("".join(lines), encoding="utf-8")
-    return path
+    return path, shorts
 
 
 def install_shell_hook(rc_file: Path | None = None) -> list[Path]:
@@ -283,6 +341,7 @@ def install_shell_hook(rc_file: Path | None = None) -> list[Path]:
     block = (
         f"\n{MARKER_BEGIN}\n"
         f"# managed by ccmd — short project commands (ana/anac/anag…)\n"
+        f"# list them anytime: ccmds   or   ccmds ana\n"
         f'[ -f "$HOME/.ccmd/shell_cmds.sh" ] && . "$HOME/.ccmd/shell_cmds.sh"\n'
         f"{MARKER_END}\n"
     )
@@ -326,22 +385,38 @@ def install_shell_hook(rc_file: Path | None = None) -> list[Path]:
     return updated
 
 
-def list_cmd_rows(projects: list | None = None) -> list[dict]:
+def list_cmd_rows(
+    projects: list | None = None,
+    *,
+    filter_text: str | None = None,
+) -> list[dict]:
     from ccmd.core.projects import ProjectRegistry
 
     projects = list(projects) if projects is not None else ProjectRegistry().list()
     shorts = allocate_shorts(projects)
     rows = []
     for p in projects:
-        s = shorts.get(p.id, "")
+        s = shorts.get(p.id, "") or getattr(p, "short", "") or ""
         rows.append(
             {
                 "short": s,
                 "project": p.id,
+                "name": p.name,
                 "default_agent": p.default_agent,
                 "path": p.path,
                 "variants": {a: f"{s}{suf}" for a, suf in AGENT_SUFFIX.items()},
             }
         )
     rows.sort(key=lambda r: r["short"])
+    if filter_text:
+        q = filter_text.strip().lower()
+        rows = [
+            r
+            for r in rows
+            if q in r["short"].lower()
+            or q in r["project"].lower()
+            or q in r["name"].lower()
+            or q in r["path"].lower()
+            or any(q in v.lower() for v in r["variants"].values())
+        ]
     return rows

{ccmd-2.0.6 → ccmd-2.0.8}/ccmd/tui/screens/browser.py

@@ -323,14 +323,24 @@ class DirBrowserScreen(Screen[bool | None]):
             self.notify(str(e), severity="error")
             return
 
+        from ccmd.core.shell_cmds import cmds_notice
+
         reg = ProjectRegistry()
         existing = reg.find_by_path(resolved)
         if existing:
             existing.default_agent = self._agent
             reg.save(existing)
+            # reload short after regen
+            existing = reg.get(existing.id) or existing
+            self.notify(
+                f"updated {existing.id} · agent {self._agent}",
+                severity="information",
+                timeout=4,
+            )
             self.notify(
-                f"already had {existing.id} — default agent → {self._agent}",
+                cmds_notice(existing),
                 severity="information",
+                timeout=8,
             )
             self.dismiss(True)
             return
@@ -342,9 +352,16 @@ class DirBrowserScreen(Screen[bool | None]):
             default_agent=self._agent,
             notes="added via browser",
         )
+        p = reg.get(p.id) or p
         self.notify(
             f"added {p.id} · agent {self._agent} → {resolved}",
             severity="information",
+            timeout=4,
+        )
+        self.notify(
+            cmds_notice(p),
+            severity="information",
+            timeout=10,
         )
         self.dismiss(True)
 

{ccmd-2.0.6 → ccmd-2.0.8}/ccmd/tui/screens/hub.py

@@ -51,6 +51,7 @@ class HubScreen(Screen):
         Binding("slash", "focus_filter", "Filter", show=False),
         Binding("/", "focus_filter", "Filter", show=True),
         Binding("escape", "blur_filter", "Esc", show=False),
+        Binding("c", "show_cmds", "Cmds", show=True),
         Binding("1", "agent_n_1", show=False),
         Binding("2", "agent_n_2", show=False),
         Binding("3", "agent_n_3", show=False),
@@ -211,11 +212,34 @@ class HubScreen(Screen):
             "agents  ]/[ cycle · 1-7 set · A set · a launch",
             *roster,
             "",
-            "enter open · d detach · b/f add from disk",
-            "shell: source ~/.ccmd/shell_cmds.sh  (or: ccmd shell install)",
+            "enter open · d detach · b/f add from disk · c show cmds",
+            "shell: ccmds  |  ccmd shell list  |  source ~/.ccmd/shell_cmds.sh",
         ]
         detail.update("\n".join(lines))
 
+    def action_show_cmds(self) -> None:
+        """Flag-style view: toast the shell shortcuts for the selected project."""
+        from ccmd.core.shell_cmds import cmds_notice, format_cmds_block
+
+        p = self._selected()
+        if not p:
+            self.notify(
+                "all cmds: run  ccmds  or  ccmd shell list",
+                severity="information",
+                timeout=6,
+            )
+            return
+        p = self.registry.get(p.id) or p
+        # multi-line block in status + toast summary
+        block = format_cmds_block(p)
+        self.query_one("#status", Static).update(block.replace("\n", " · "))
+        self.notify(cmds_notice(p), severity="information", timeout=10)
+        self.notify(
+            f"{p.short or p.id}: c={p.short}c g={p.short}g x={p.short}x u={p.short}u",
+            severity="information",
+            timeout=8,
+        )
+
     def _set_default_agent(self, agent_id: str, *, notify: bool = True) -> None:
         p = self._selected()
         if not p:
@@ -226,8 +250,16 @@ class HubScreen(Screen):
             return
         p.default_agent = agent_id
         self.registry.save(p)
+        p = self.registry.get(p.id) or p
         if notify:
-            self.notify(f"{p.id} → default agent {agent_id}", severity="information")
+            from ccmd.core.shell_cmds import cmds_notice
+
+            self.notify(
+                f"{p.id} → default agent {agent_id}",
+                severity="information",
+                timeout=3,
+            )
+            self.notify(cmds_notice(p), severity="information", timeout=8)
         self._load_projects(self.query_one("#filter", Input).value)
 
     def _cycle_agent(self, delta: int) -> None:

{ccmd-2.0.6 → ccmd-2.0.8}/ccmd/tui/screens/project_edit.py

@@ -45,8 +45,12 @@ class ProjectEditScreen(Screen[bool | None]):
         if not p.is_dir():
             self.notify(f"not a directory: {p}", severity="error")
             return
-        ProjectRegistry().add(name=name, path=p, default_agent=agent)
-        self.notify(f"added {name}", severity="information")
+        from ccmd.core.shell_cmds import cmds_notice
+
+        proj = ProjectRegistry().add(name=name, path=p, default_agent=agent)
+        proj = ProjectRegistry().get(proj.id) or proj
+        self.notify(f"added {name}", severity="information", timeout=3)
+        self.notify(cmds_notice(proj), severity="information", timeout=10)
         self.dismiss(True)
 
     def action_cancel(self) -> None:

{ccmd-2.0.6 → ccmd-2.0.8/ccmd.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: ccmd
-Version: 2.0.6
+Version: 2.0.8
 Summary: ccmd — Agentic Project Hub. Pick a project, pick an agent, launch.
 Author-email: De Catalyst <Robert5560newton@gmail.com>
 License: MIT

{ccmd-2.0.6 → ccmd-2.0.8}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "ccmd"
-version = "2.0.6"
+version = "2.0.8"
 description = "ccmd — Agentic Project Hub. Pick a project, pick an agent, launch."
 readme = "README.md"
 requires-python = ">=3.11"