steerdev 0.5.7__tar.gz → 0.5.8__tar.gz

{steerdev-0.5.7 → steerdev-0.5.8}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: steerdev
-Version: 0.5.7
+Version: 0.5.8
 Summary: Backend task runner for steerdev.com - orchestrates CLI coding agents with activity reporting
 Project-URL: Homepage, https://github.com/pentoai/steerdev-agent
 Project-URL: Repository, https://github.com/pentoai/steerdev-agent
@@ -60,6 +60,15 @@ cd steerdev
 uv tool install .
 ```
 
+### Updating
+
+The CLI automatically checks for new versions. When an update is available you'll see:
+
+```
+Update available: 0.5.5 → 0.5.6
+Run uv tool install steerdev to upgrade
+```
+
 ## Quick Start
 
 ### 1. Set Up Your Project
@@ -86,6 +95,12 @@ steerdev run --project-id YOUR_PROJECT_ID
 # Run a specific task
 steerdev run --project-id YOUR_PROJECT_ID --task-id TASK_ID
 
+# Run with git worktree isolation
+steerdev run --project-id YOUR_PROJECT_ID --worktrees
+
+# Run with a multi-phase workflow
+steerdev run --project-id YOUR_PROJECT_ID --workflow-id WORKFLOW_ID
+
 # Resume an existing session
 steerdev resume --session-id SESSION_ID --message "Continue working..."
 ```
@@ -99,7 +114,29 @@ Run the agent against a project or specific task.
 ```bash
 steerdev run --project-id PROJECT_ID
 steerdev run --project-id PROJECT_ID --task-id TASK_ID
-steerdev run -c agent.yaml --prompt "Fix the failing tests"
+steerdev run --project-id PROJECT_ID --worktrees
+steerdev run --project-id PROJECT_ID --workflow-id WORKFLOW_ID
+steerdev run --project-id PROJECT_ID --agent-name my-dev-agent
+steerdev run --project-id PROJECT_ID --max-tasks 5    # process multiple tasks
+steerdev run --project-id PROJECT_ID --dry             # preview without executing
+```
+
+### `steerdev daemon`
+
+Run the agent in persistent daemon mode — polls for commands from the dashboard/API and falls back to the task queue.
+
+```bash
+steerdev daemon --project-id PROJECT_ID --agent-name my-agent
+steerdev daemon --project-id PROJECT_ID --agent-name my-agent --no-auto-fetch-tasks
+steerdev daemon --project-id PROJECT_ID --agent-name my-agent --poll-interval 10
+```
+
+### `steerdev resume`
+
+Resume an existing session with a new message.
+
+```bash
+steerdev resume --session-id SESSION_ID --message "Continue working..."
 ```
 
 ### `steerdev tasks`
@@ -107,28 +144,99 @@ steerdev run -c agent.yaml --prompt "Fix the failing tests"
 Manage tasks from your SteerDev project.
 
 ```bash
-steerdev tasks next          # Get the next task to work on
-steerdev tasks list          # List all tasks
-steerdev tasks get TASK_ID   # Get task details
+steerdev tasks next                              # Get the next task to work on
+steerdev tasks list                              # List all tasks
+steerdev tasks get TASK_ID                       # Get task details
 steerdev tasks update TASK_ID --status in-progress
+steerdev tasks create --title "..." --prompt "..."
+```
+
+### `steerdev specs`
+
+Manage specification documents.
+
+```bash
+steerdev specs list                              # List specifications
+steerdev specs get SPEC_ID                       # Get spec details
+steerdev specs create --title "..."              # Create a new spec
+steerdev specs update SPEC_ID --status approved  # Update a spec
 ```
 
 ### `steerdev setup`
 
-Configure your project for use with the agent.
+Configure a project for use with the agent. Sets up `.claude/settings.json`, skills, `.env`, and `CLAUDE.md`.
 
 ```bash
 steerdev setup --project-id YOUR_PROJECT_ID --api-key YOUR_API_KEY
+steerdev setup --install-target user             # Install to ~/.claude/ instead of .claude/
+steerdev setup --agent-name my-agent             # Set a custom agent name
+```
+
+### `steerdev sync`
+
+Sync shared agent settings (system prompts, skills, MCP servers, env variables) from the platform.
+
+```bash
+steerdev sync --project-id PROJECT_ID
+steerdev sync --project-id PROJECT_ID --install-target user
+```
+
+### `steerdev sessions`
+
+List and inspect agent execution sessions.
+
+```bash
+steerdev sessions list
+steerdev sessions get SESSION_ID
+```
+
+### `steerdev runs`
+
+List and inspect agent execution runs.
+
+```bash
+steerdev runs list
+steerdev runs get RUN_ID
+steerdev runs active                             # List currently active runs
+```
+
+### `steerdev activity`
+
+Self-report progress or query activity history.
+
+```bash
+steerdev activity report --message "Completed auth module"
+steerdev activity query
+```
+
+### `steerdev context`
+
+Manage project context (tech stack, patterns, structure).
+
+```bash
+steerdev context get
+steerdev context refresh                         # Force refresh cached context
+```
+
+### `steerdev git`
+
+Git workflow commands with steerdev conventions.
+
+```bash
+steerdev git branch TASK_ID                      # Create a task branch
+steerdev git pr                                  # Create a PR with conventions
+steerdev git status                              # Show branch and task context
 ```
 
-### `steerdev config`
+### `steerdev hooks`
 
-Manage YAML configuration files.
+Claude Code lifecycle hooks for activity reporting (used internally by the Claude Code integration).
 
 ```bash
-steerdev config init --output agent.yaml   # Generate config
-steerdev config validate agent.yaml         # Validate config
-steerdev config show agent.yaml             # Show config
+steerdev hooks session-start
+steerdev hooks session-end
+steerdev hooks agent-stop
+steerdev hooks subagent-stop
 ```
 
 ## Configuration
@@ -164,6 +272,7 @@ worktrees:
 | --- | --- |
 | `STEERDEV_API_KEY` | API key for steerdev.com |
 | `STEERDEV_PROJECT_ID` | Default project ID |
+| `STEERDEV_AGENT_NAME` | Agent name for session tracking |
 
 > **Note:** CLI agents (Claude Code, Codex, etc.) must be logged in independently before running steerdev. No LLM API keys are needed here.
 
@@ -188,12 +297,14 @@ steerdev run
 | --- | --- |
 | `cli.py` | Typer CLI entry point |
 | `runner.py` | Main orchestrator |
+| `daemon.py` | Persistent daemon mode |
 | `executor/` | Agent subprocess management |
 | `api/` | SteerDev API clients |
 | `prompt/` | Prompt building and templates |
 | `workflow/` | Multi-phase workflow execution |
 | `config/` | Configuration models and settings |
 | `setup/` | Project setup utilities |
+| `git/` | Git workflow utilities |
 
 ## Development
 

{steerdev-0.5.7 → steerdev-0.5.8}/README.md

@@ -24,6 +24,15 @@ cd steerdev
 uv tool install .
 ```
 
+### Updating
+
+The CLI automatically checks for new versions. When an update is available you'll see:
+
+```
+Update available: 0.5.5 → 0.5.6
+Run uv tool install steerdev to upgrade
+```
+
 ## Quick Start
 
 ### 1. Set Up Your Project
@@ -50,6 +59,12 @@ steerdev run --project-id YOUR_PROJECT_ID
 # Run a specific task
 steerdev run --project-id YOUR_PROJECT_ID --task-id TASK_ID
 
+# Run with git worktree isolation
+steerdev run --project-id YOUR_PROJECT_ID --worktrees
+
+# Run with a multi-phase workflow
+steerdev run --project-id YOUR_PROJECT_ID --workflow-id WORKFLOW_ID
+
 # Resume an existing session
 steerdev resume --session-id SESSION_ID --message "Continue working..."
 ```
@@ -63,7 +78,29 @@ Run the agent against a project or specific task.
 ```bash
 steerdev run --project-id PROJECT_ID
 steerdev run --project-id PROJECT_ID --task-id TASK_ID
-steerdev run -c agent.yaml --prompt "Fix the failing tests"
+steerdev run --project-id PROJECT_ID --worktrees
+steerdev run --project-id PROJECT_ID --workflow-id WORKFLOW_ID
+steerdev run --project-id PROJECT_ID --agent-name my-dev-agent
+steerdev run --project-id PROJECT_ID --max-tasks 5    # process multiple tasks
+steerdev run --project-id PROJECT_ID --dry             # preview without executing
+```
+
+### `steerdev daemon`
+
+Run the agent in persistent daemon mode — polls for commands from the dashboard/API and falls back to the task queue.
+
+```bash
+steerdev daemon --project-id PROJECT_ID --agent-name my-agent
+steerdev daemon --project-id PROJECT_ID --agent-name my-agent --no-auto-fetch-tasks
+steerdev daemon --project-id PROJECT_ID --agent-name my-agent --poll-interval 10
+```
+
+### `steerdev resume`
+
+Resume an existing session with a new message.
+
+```bash
+steerdev resume --session-id SESSION_ID --message "Continue working..."
 ```
 
 ### `steerdev tasks`
@@ -71,28 +108,99 @@ steerdev run -c agent.yaml --prompt "Fix the failing tests"
 Manage tasks from your SteerDev project.
 
 ```bash
-steerdev tasks next          # Get the next task to work on
-steerdev tasks list          # List all tasks
-steerdev tasks get TASK_ID   # Get task details
+steerdev tasks next                              # Get the next task to work on
+steerdev tasks list                              # List all tasks
+steerdev tasks get TASK_ID                       # Get task details
 steerdev tasks update TASK_ID --status in-progress
+steerdev tasks create --title "..." --prompt "..."
+```
+
+### `steerdev specs`
+
+Manage specification documents.
+
+```bash
+steerdev specs list                              # List specifications
+steerdev specs get SPEC_ID                       # Get spec details
+steerdev specs create --title "..."              # Create a new spec
+steerdev specs update SPEC_ID --status approved  # Update a spec
 ```
 
 ### `steerdev setup`
 
-Configure your project for use with the agent.
+Configure a project for use with the agent. Sets up `.claude/settings.json`, skills, `.env`, and `CLAUDE.md`.
 
 ```bash
 steerdev setup --project-id YOUR_PROJECT_ID --api-key YOUR_API_KEY
+steerdev setup --install-target user             # Install to ~/.claude/ instead of .claude/
+steerdev setup --agent-name my-agent             # Set a custom agent name
+```
+
+### `steerdev sync`
+
+Sync shared agent settings (system prompts, skills, MCP servers, env variables) from the platform.
+
+```bash
+steerdev sync --project-id PROJECT_ID
+steerdev sync --project-id PROJECT_ID --install-target user
+```
+
+### `steerdev sessions`
+
+List and inspect agent execution sessions.
+
+```bash
+steerdev sessions list
+steerdev sessions get SESSION_ID
+```
+
+### `steerdev runs`
+
+List and inspect agent execution runs.
+
+```bash
+steerdev runs list
+steerdev runs get RUN_ID
+steerdev runs active                             # List currently active runs
+```
+
+### `steerdev activity`
+
+Self-report progress or query activity history.
+
+```bash
+steerdev activity report --message "Completed auth module"
+steerdev activity query
+```
+
+### `steerdev context`
+
+Manage project context (tech stack, patterns, structure).
+
+```bash
+steerdev context get
+steerdev context refresh                         # Force refresh cached context
+```
+
+### `steerdev git`
+
+Git workflow commands with steerdev conventions.
+
+```bash
+steerdev git branch TASK_ID                      # Create a task branch
+steerdev git pr                                  # Create a PR with conventions
+steerdev git status                              # Show branch and task context
 ```
 
-### `steerdev config`
+### `steerdev hooks`
 
-Manage YAML configuration files.
+Claude Code lifecycle hooks for activity reporting (used internally by the Claude Code integration).
 
 ```bash
-steerdev config init --output agent.yaml   # Generate config
-steerdev config validate agent.yaml         # Validate config
-steerdev config show agent.yaml             # Show config
+steerdev hooks session-start
+steerdev hooks session-end
+steerdev hooks agent-stop
+steerdev hooks subagent-stop
 ```
 
 ## Configuration
@@ -128,6 +236,7 @@ worktrees:
 | --- | --- |
 | `STEERDEV_API_KEY` | API key for steerdev.com |
 | `STEERDEV_PROJECT_ID` | Default project ID |
+| `STEERDEV_AGENT_NAME` | Agent name for session tracking |
 
 > **Note:** CLI agents (Claude Code, Codex, etc.) must be logged in independently before running steerdev. No LLM API keys are needed here.
 
@@ -152,12 +261,14 @@ steerdev run
 | --- | --- |
 | `cli.py` | Typer CLI entry point |
 | `runner.py` | Main orchestrator |
+| `daemon.py` | Persistent daemon mode |
 | `executor/` | Agent subprocess management |
 | `api/` | SteerDev API clients |
 | `prompt/` | Prompt building and templates |
 | `workflow/` | Multi-phase workflow execution |
 | `config/` | Configuration models and settings |
 | `setup/` | Project setup utilities |
+| `git/` | Git workflow utilities |
 
 ## Development
 

{steerdev-0.5.7 → steerdev-0.5.8}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "steerdev"
-version = "0.5.7"
+version = "0.5.8"
 description = "Backend task runner for steerdev.com - orchestrates CLI coding agents with activity reporting"
 readme = "README.md"
 authors = [