devmux 0.2.0__tar.gz → 0.2.2__tar.gz

{devmux-0.2.0 → devmux-0.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devmux
-Version: 0.2.0
+Version: 0.2.2
 Summary: A tmux session manager purpose-built for AI agent CLIs
 Author-email: Ollayor <ollayor@example.com>
 Project-URL: Homepage, https://github.com/olllayor/devmux
@@ -179,7 +179,7 @@ Legacy `agents` configs are still accepted and mapped to `role: agent`.
 
 ```bash
 devmux init [--preset minimal|backend|full-stack] [--config PATH] [--force]
-devmux start <workspace> [--config PATH] [--detach] [--recreate]
+devmux start [<workspace>] [--config PATH] [--preset minimal|backend|full-stack] [--detach] [--recreate]
 devmux attach <workspace>
 devmux resume <workspace>
 devmux ls
@@ -187,6 +187,14 @@ devmux kill <workspace>
 devmux send "<prompt>" [--session NAME] [--all | --role ROLE | --pane NAME ...]
 ```
 
+You can also skip editing `devmux.yaml` for a quick start:
+
+```bash
+devmux start my-project --preset backend
+# or, from inside a project directory:
+devmux start --preset backend
+```
+
 ## Typical workflows
 
 ### Two-agent coding setup
@@ -256,7 +264,7 @@ Use two distribution paths:
 Recommended rollout order:
 
 1. Push this repo to GitHub with a clean README, license, and tagged release.
-2. Publish version `0.2.0` to PyPI.
+2. Push a version tag like `vX.Y.Z`; GitHub Actions creates the release and publishes to PyPI.
 3. Share a short demo GIF/video showing `devmux init`, `devmux start`, and `devmux send`.
 4. Post it in places where AI-heavy CLI devs already are: X, Reddit, Hacker News, tmux/devtools communities, Discord/Slack groups, and your own network.
 

{devmux-0.2.0 → devmux-0.2.2}/README.md

@@ -160,7 +160,7 @@ Legacy `agents` configs are still accepted and mapped to `role: agent`.
 
 ```bash
 devmux init [--preset minimal|backend|full-stack] [--config PATH] [--force]
-devmux start <workspace> [--config PATH] [--detach] [--recreate]
+devmux start [<workspace>] [--config PATH] [--preset minimal|backend|full-stack] [--detach] [--recreate]
 devmux attach <workspace>
 devmux resume <workspace>
 devmux ls
@@ -168,6 +168,14 @@ devmux kill <workspace>
 devmux send "<prompt>" [--session NAME] [--all | --role ROLE | --pane NAME ...]
 ```
 
+You can also skip editing `devmux.yaml` for a quick start:
+
+```bash
+devmux start my-project --preset backend
+# or, from inside a project directory:
+devmux start --preset backend
+```
+
 ## Typical workflows
 
 ### Two-agent coding setup
@@ -237,7 +245,7 @@ Use two distribution paths:
 Recommended rollout order:
 
 1. Push this repo to GitHub with a clean README, license, and tagged release.
-2. Publish version `0.2.0` to PyPI.
+2. Push a version tag like `vX.Y.Z`; GitHub Actions creates the release and publishes to PyPI.
 3. Share a short demo GIF/video showing `devmux init`, `devmux start`, and `devmux send`.
 4. Post it in places where AI-heavy CLI devs already are: X, Reddit, Hacker News, tmux/devtools communities, Discord/Slack groups, and your own network.
 

{devmux-0.2.0 → devmux-0.2.2}/devmux/__init__.py

@@ -1,3 +1,3 @@
 """devmux - A tmux session manager for AI agent CLIs."""
 
-__version__ = "0.2.0"
+__version__ = "0.2.2"

{devmux-0.2.0 → devmux-0.2.2}/devmux/cli/main.py

@@ -10,7 +10,13 @@ import click
 
 from devmux import __version__
 from devmux.core.manager import SessionManager, SessionManagerError
-from devmux.utils.config import Config, ConfigError, VALID_ROLES, render_preset
+from devmux.utils.config import (
+    Config,
+    ConfigError,
+    VALID_ROLES,
+    load_preset,
+    render_preset,
+)
 
 
 def _load_config(config_path: str) -> Config:
@@ -25,6 +31,33 @@ def _fail(exc: Exception) -> None:
     raise SystemExit(1) from exc
 
 
+def _resolve_start_request(
+    workspace_name: str | None, config_path: str, preset: str | None
+) -> tuple[str, Config]:
+    if preset:
+        resolved_name = workspace_name or Path.cwd().resolve().name
+        return resolved_name, load_preset(
+            preset, workspace_name=resolved_name, base_dir=Path.cwd().resolve()
+        )
+
+    if not workspace_name:
+        raise click.UsageError(
+            "Missing argument 'WORKSPACE_NAME'. Or pass --preset to start from a built-in template."
+        )
+
+    cfg = _load_config(config_path)
+    if workspace_name in cfg.workspaces:
+        return workspace_name, cfg
+
+    available = ", ".join(sorted(cfg.workspaces)) or "(none)"
+    raise ConfigError(
+        f"Workspace '{workspace_name}' not found in config '{config_path}'. "
+        f"Available workspaces: {available}. "
+        f"Start one of those, add '{workspace_name}' under 'workspaces', "
+        f"or run 'devmux start {workspace_name} --preset backend'."
+    )
+
+
 @click.group()
 @click.version_option(version=__version__)
 def cli() -> None:
@@ -68,7 +101,7 @@ def init(preset: str, config: str, force: bool) -> None:
 
 
 @cli.command()
-@click.argument("workspace_name")
+@click.argument("workspace_name", required=False)
 @click.option(
     "--config",
     "-c",
@@ -76,6 +109,11 @@ def init(preset: str, config: str, force: bool) -> None:
     show_default=True,
     help="Path to config file.",
 )
+@click.option(
+    "--preset",
+    type=click.Choice(["minimal", "backend", "full-stack"]),
+    help="Use a built-in preset without reading devmux.yaml. If WORKSPACE_NAME is omitted, the current directory name is used.",
+)
 @click.option(
     "--detach",
     is_flag=True,
@@ -86,10 +124,16 @@ def init(preset: str, config: str, force: bool) -> None:
     is_flag=True,
     help="Kill any existing session with the same name before creating it again.",
 )
-def start(workspace_name: str, config: str, detach: bool, recreate: bool) -> None:
+def start(
+    workspace_name: str | None,
+    config: str,
+    preset: str | None,
+    detach: bool,
+    recreate: bool,
+) -> None:
     """Create or resume a named workspace."""
     try:
-        cfg = _load_config(config)
+        workspace_name, cfg = _resolve_start_request(workspace_name, config, preset)
         manager = SessionManager()
         result = manager.start_workspace(workspace_name, cfg, recreate=recreate)
 

{devmux-0.2.0 → devmux-0.2.2}/devmux/core/manager.py

@@ -212,7 +212,10 @@ class SessionManager:
         return workspace
 
     def _find_session(self, workspace_name: str) -> Session | None:
-        return self.server.sessions.get(session_name=workspace_name)
+        try:
+            return self.server.sessions.get(session_name=workspace_name)
+        except Exception:
+            return None
 
     def _current_session_name(self) -> str | None:
         pane_id = os.environ.get("TMUX_PANE")

{devmux-0.2.0 → devmux-0.2.2}/devmux/utils/config.py

@@ -99,7 +99,17 @@ class Config:
     def load(cls, path: Path) -> "Config":
         with path.open("r", encoding="utf-8") as handle:
             data = yaml.safe_load(handle) or {}
+        return cls.from_mapping(data, base_dir=path.parent.resolve())
 
+    @classmethod
+    def from_text(cls, raw: str, base_dir: Path | None = None) -> "Config":
+        data = yaml.safe_load(raw) or {}
+        return cls.from_mapping(data, base_dir=base_dir)
+
+    @classmethod
+    def from_mapping(
+        cls, data: dict[str, Any], base_dir: Path | None = None
+    ) -> "Config":
         if not isinstance(data, dict):
             raise ConfigError("The config file must contain a top-level mapping.")
 
@@ -122,7 +132,7 @@ class Config:
                 layout=layout,
                 cwd=workspace_cwd,
                 panes=panes,
-                base_dir=path.parent.resolve(),
+                base_dir=(base_dir or Path.cwd()).resolve(),
             )
             workspace.validate(workspace_name)
             workspaces[workspace_name] = workspace
@@ -228,3 +238,16 @@ workspaces:
             f"Unknown preset '{preset}'. Choose one of: minimal, backend, full-stack."
         )
     return presets[preset]
+
+
+def load_preset(
+    preset: str, workspace_name: str, base_dir: Path | None = None
+) -> Config:
+    data = yaml.safe_load(render_preset(preset)) or {}
+    workspaces_data = data.get("workspaces", {})
+    if not isinstance(workspaces_data, dict) or not workspaces_data:
+        raise ConfigError(f"Preset '{preset}' did not define any workspaces.")
+
+    _, workspace_template = next(iter(workspaces_data.items()))
+    data["workspaces"] = {workspace_name: workspace_template}
+    return Config.from_mapping(data, base_dir=base_dir)

{devmux-0.2.0 → devmux-0.2.2}/devmux.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devmux
-Version: 0.2.0
+Version: 0.2.2
 Summary: A tmux session manager purpose-built for AI agent CLIs
 Author-email: Ollayor <ollayor@example.com>
 Project-URL: Homepage, https://github.com/olllayor/devmux
@@ -179,7 +179,7 @@ Legacy `agents` configs are still accepted and mapped to `role: agent`.
 
 ```bash
 devmux init [--preset minimal|backend|full-stack] [--config PATH] [--force]
-devmux start <workspace> [--config PATH] [--detach] [--recreate]
+devmux start [<workspace>] [--config PATH] [--preset minimal|backend|full-stack] [--detach] [--recreate]
 devmux attach <workspace>
 devmux resume <workspace>
 devmux ls
@@ -187,6 +187,14 @@ devmux kill <workspace>
 devmux send "<prompt>" [--session NAME] [--all | --role ROLE | --pane NAME ...]
 ```
 
+You can also skip editing `devmux.yaml` for a quick start:
+
+```bash
+devmux start my-project --preset backend
+# or, from inside a project directory:
+devmux start --preset backend
+```
+
 ## Typical workflows
 
 ### Two-agent coding setup
@@ -256,7 +264,7 @@ Use two distribution paths:
 Recommended rollout order:
 
 1. Push this repo to GitHub with a clean README, license, and tagged release.
-2. Publish version `0.2.0` to PyPI.
+2. Push a version tag like `vX.Y.Z`; GitHub Actions creates the release and publishes to PyPI.
 3. Share a short demo GIF/video showing `devmux init`, `devmux start`, and `devmux send`.
 4. Post it in places where AI-heavy CLI devs already are: X, Reddit, Hacker News, tmux/devtools communities, Discord/Slack groups, and your own network.
 

{devmux-0.2.0 → devmux-0.2.2}/devmux.egg-info/SOURCES.txt

@@ -15,4 +15,5 @@ devmux/utils/__init__.py
 devmux/utils/config.py
 tests/test_cli.py
 tests/test_config.py
-tests/test_manager.py
+tests/test_manager.py
+tests/test_version.py

{devmux-0.2.0 → devmux-0.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "devmux"
-version = "0.2.0"
+version = "0.2.2"
 description = "A tmux session manager purpose-built for AI agent CLIs"
 authors = [
     {name = "Ollayor", email = "ollayor@example.com"}

{devmux-0.2.0 → devmux-0.2.2}/tests/test_cli.py

@@ -54,6 +54,21 @@ def test_resume_calls_attach(monkeypatch) -> None:
     assert fake_manager.attached == ["backend"]
 
 
+def test_attach_missing_session_shows_real_error(monkeypatch) -> None:
+    runner = CliRunner()
+
+    class MissingManager:
+        def attach_session(self, workspace_name):
+            raise RuntimeError(f"Session '{workspace_name}' does not exist.")
+
+    monkeypatch.setattr("devmux.cli.main.SessionManager", lambda: MissingManager())
+
+    result = runner.invoke(cli, ["attach", "codex"])
+
+    assert result.exit_code == 1
+    assert "Session 'codex' does not exist." in result.output
+
+
 def test_start_with_detach_uses_idempotent_manager(monkeypatch, tmp_path: Path) -> None:
     runner = CliRunner()
     fake_manager = FakeManager()
@@ -86,6 +101,67 @@ workspaces:
     assert "detached session 'backend'" in result.output
 
 
+def test_start_with_preset_bootstraps_named_workspace(monkeypatch) -> None:
+    runner = CliRunner()
+    fake_manager = FakeManager()
+    monkeypatch.setattr("devmux.cli.main.SessionManager", lambda: fake_manager)
+
+    result = runner.invoke(cli, ["start", "agenix", "--preset", "backend", "--detach"])
+
+    assert result.exit_code == 0
+    assert fake_manager.started == [("agenix", False, ["agenix"])]
+    assert "detached session 'agenix'" in result.output
+
+
+def test_start_with_preset_uses_current_directory_name(monkeypatch, tmp_path: Path) -> None:
+    runner = CliRunner()
+    fake_manager = FakeManager()
+    project_dir = tmp_path / "agenix"
+    project_dir.mkdir()
+    monkeypatch.chdir(project_dir)
+    monkeypatch.setattr("devmux.cli.main.SessionManager", lambda: fake_manager)
+
+    result = runner.invoke(cli, ["start", "--preset", "backend", "--detach"])
+
+    assert result.exit_code == 0
+    assert fake_manager.started == [("agenix", False, ["agenix"])]
+    assert "detached session 'agenix'" in result.output
+
+
+def test_start_unknown_workspace_shows_available_workspaces(monkeypatch, tmp_path: Path) -> None:
+    runner = CliRunner()
+    config_path = tmp_path / "devmux.yaml"
+    config_path.write_text(
+        """
+workspaces:
+  backend:
+    layout: duo
+    cwd: .
+    panes:
+      - name: planner
+        role: agent
+        command: "claude"
+      - name: builder
+        role: agent
+        command: "codex --approval auto"
+""",
+        encoding="utf-8",
+    )
+
+    class UnusedManager:
+        def start_workspace(self, workspace_name, config, recreate=False):  # pragma: no cover
+            raise AssertionError("manager should not be called when the workspace is missing")
+
+    monkeypatch.setattr("devmux.cli.main.SessionManager", lambda: UnusedManager())
+
+    result = runner.invoke(cli, ["start", "agenix", "--config", str(config_path)])
+
+    assert result.exit_code == 1
+    assert "Workspace 'agenix' not found" in result.output
+    assert "Available workspaces: backend" in result.output
+    assert "devmux start agenix --preset backend" in result.output
+
+
 def test_send_enforces_safe_flag_combinations(monkeypatch) -> None:
     runner = CliRunner()
     fake_manager = FakeManager()

{devmux-0.2.0 → devmux-0.2.2}/tests/test_config.py

@@ -2,7 +2,7 @@ from __future__ import annotations
 
 import pytest
 
-from devmux.utils.config import Config, ConfigError
+from devmux.utils.config import Config, ConfigError, load_preset
 
 
 def test_loads_new_panes_schema(write_config) -> None:
@@ -58,6 +58,15 @@ def test_loads_legacy_agents_schema_as_agent_panes(write_config) -> None:
     assert workspace.panes[1].command == "codex --approval auto"
 
 
+def test_load_preset_rekeys_workspace_name(tmp_path) -> None:
+    config = load_preset("backend", workspace_name="agenix", base_dir=tmp_path)
+
+    assert sorted(config.workspaces) == ["agenix"]
+    workspace = config.workspaces["agenix"]
+    assert workspace.layout == "trio"
+    assert workspace.base_dir == tmp_path.resolve()
+
+
 @pytest.mark.parametrize(
     ("contents", "message"),
     [

devmux-0.2.2/tests/test_version.py

@@ -0,0 +1,13 @@
+from __future__ import annotations
+
+from pathlib import Path
+import tomllib
+
+from devmux import __version__
+
+
+def test_package_version_matches_pyproject() -> None:
+    with Path("pyproject.toml").open("rb") as handle:
+        pyproject = tomllib.load(handle)
+
+    assert __version__ == pyproject["project"]["version"]