Update skill installation (don't edit global agent files) and bump version

Author: aliroberts

README.md

@@ -126,6 +126,27 @@ For more advanced examples, including [Triton](/examples/triton/README.md), [CUD
 | `weco credits topup [amount]` | Purchase additional credits | When you need more credits (default: 10) |
 | `weco credits autotopup` | Configure automatic top-up | Set up automatic credit replenishment |
 
+### Observe Commands
+
+Track experiments from your own optimization loop (LLM agents, custom scripts, manual experiments) in the Weco dashboard:
+
+| Command | Description |
+|---------|-------------|
+| `weco observe init` | Create a run and print the run ID |
+| `weco observe log` | Log a step with metrics and code |
+
+```bash
+# Initialize a run
+WECO_RUN_ID=$(weco observe init --name "my-experiment" --metric val_bpb --goal min --source train.py)
+
+# Log baseline (step 0) and experiments (step 1, 2, ...)
+weco observe log --run-id "$WECO_RUN_ID" --step 0 --description "baseline" --metrics '{"val_bpb": 2.36}' --source train.py
+weco observe log --run-id "$WECO_RUN_ID" --step 1 --description "increase batch size" --metrics '{"val_bpb": 2.26}' --source train.py
+weco observe log --run-id "$WECO_RUN_ID" --step 2 --status failed --description "OOM" --metrics '{"val_bpb": 0.0}'
+```
+
+All observe commands are fire-and-forget — they always exit 0, so they never crash an agent's loop. For branching, pass `--parent-step` explicitly. See `weco observe init --help` and `weco observe log --help` for all options.
+
 ### Setup Commands (Experimental)
 
 | Command | Description |

pyproject.toml

@@ -8,7 +8,7 @@ name = "weco"
 authors = [{ name = "Weco AI Team", email = "contact@weco.ai" }]
 description = "Documentation for `weco`, a CLI for using Weco AI's code optimizer."
 readme = "README.md"
-version = "0.3.19"
+version = "0.3.20"
 license = { file = "LICENSE" }
 requires-python = ">=3.9"
 dependencies = [

weco/observe/cli.py

@@ -10,7 +10,9 @@
 import warnings
 
 from weco.auth import handle_authentication
+from weco.browser import open_browser
 from weco.observe import api
+from weco import __dashboard_url__
 
 
 def configure_observe_parser(observe_parser: argparse.ArgumentParser) -> None:
@@ -117,8 +119,12 @@ def _handle_init(args: argparse.Namespace, auth_headers: dict) -> None:
     )
 
     if result and result.get("run_id"):
+        run_id = result["run_id"]
         # Print only the run_id to stdout so it can be captured by $(...)
-        print(result["run_id"])
+        print(run_id)
+        # Open the dashboard in the user's browser
+        dashboard_url = f"{__dashboard_url__}/runs/{run_id}"
+        open_browser(dashboard_url)
     else:
         print("weco observe: failed to create run", file=sys.stderr)
 

weco/setup.py

@@ -14,7 +14,7 @@
 from urllib.request import urlopen
 
 from rich.console import Console
-from rich.prompt import Confirm, Prompt
+from rich.prompt import Prompt
 
 from .events import (
     send_event,
@@ -23,7 +23,7 @@
     SkillInstallCompletedEvent,
     SkillInstallFailedEvent,
 )
-from .utils import copy_directory, copy_file, read_from_path, write_to_path
+from .utils import copy_directory, copy_file
 
 
 # =============================================================================
@@ -69,20 +69,10 @@ class SafetyError(SetupError):
 WECO_SKILL_DIR = CLAUDE_SKILLS_DIR / "weco"
 WECO_CLAUDE_SNIPPET_PATH = WECO_SKILL_DIR / "snippets" / "claude.md"
 WECO_CLAUDE_MD_PATH = WECO_SKILL_DIR / "CLAUDE.md"
-CLAUDE_MD_PATH = CLAUDE_DIR / "CLAUDE.md"
-WECO_CLAUDE_GLOBAL_SNIPPET_PATH = WECO_SKILL_DIR / "snippets" / "claude-global.md"
-
-# Section markers for the global ~/.claude/CLAUDE.md
-WECO_SECTION_START = "<!-- WECO_START -->"
-WECO_SECTION_END = "<!-- WECO_END -->"
-
 # Cursor paths
 CURSOR_DIR = pathlib.Path.home() / ".cursor"
-CURSOR_RULES_DIR = CURSOR_DIR / "rules"
-CURSOR_WECO_RULES_PATH = CURSOR_RULES_DIR / "weco.mdc"
 CURSOR_SKILLS_DIR = CURSOR_DIR / "skills"
 CURSOR_WECO_SKILL_DIR = CURSOR_SKILLS_DIR / "weco"
-CURSOR_RULES_SNIPPET_PATH = CURSOR_WECO_SKILL_DIR / "snippets" / "cursor.md"
 
 # Files/directories to skip when copying local repos
 _COPY_IGNORE_PATTERNS = {".git", "__pycache__", ".DS_Store"}
@@ -175,53 +165,6 @@ def safe_remove_directory(path: pathlib.Path, allowed_parents: set[pathlib.Path]
 # =============================================================================
 
 
-def generate_cursor_mdc_content(snippet_content: str) -> str:
-    """Generate Cursor MDC file content with YAML frontmatter."""
-    return f"""---
-description: Weco code optimization skill. Weco automates optimization by iteratively refining code against any metric you define — invoke for speed, accuracy, latency, cost, or anything else you can measure.
-alwaysApply: true
----
-{snippet_content}
-"""
-
-
-def generate_weco_claude_section(snippet_content: str) -> str:
-    """Generate the Weco section for the global ~/.claude/CLAUDE.md with marker tags."""
-    return f"""{WECO_SECTION_START}
-{snippet_content}
-{WECO_SECTION_END}"""
-
-
-def extract_weco_section(content: str) -> str | None:
-    """Extract the Weco section from file content, or None if not present."""
-    if WECO_SECTION_START not in content or WECO_SECTION_END not in content:
-        return None
-    start = content.index(WECO_SECTION_START)
-    end = content.index(WECO_SECTION_END) + len(WECO_SECTION_END)
-    return content[start:end]
-
-
-def upsert_weco_section(file_path: pathlib.Path, section: str) -> None:
-    """
-    Insert or replace the Weco section in a file.
-
-    - If the file has existing WECO_START/WECO_END markers, replace that region.
-    - If the file exists but has no markers, append the section.
-    - If the file doesn't exist, create it with the section.
-    """
-    if file_path.exists():
-        content = read_from_path(file_path)
-        existing = extract_weco_section(content)
-        if existing is not None:
-            content = content.replace(existing, section)
-        else:
-            content = content.rstrip() + "\n\n" + section + "\n"
-    else:
-        content = section + "\n"
-
-    write_to_path(file_path, content, mkdir=True)
-
-
 def validate_local_skill_repo(local_path: pathlib.Path) -> None:
     """
     Validate that a local path is a valid weco-skill repository.
@@ -413,96 +356,22 @@ def setup_claude_code(console: Console, local_path: pathlib.Path | None = None)
     copy_file(WECO_CLAUDE_SNIPPET_PATH, WECO_CLAUDE_MD_PATH)
     console.print("[green]CLAUDE.md installed to skill directory.[/]")
 
-    # Update global ~/.claude/CLAUDE.md with a Weco section.
-    # The global file is user-managed and may contain other content, so we use
-    # section markers (WECO_START/WECO_END) to insert or replace only our section.
-    snippet_content = read_from_path(WECO_CLAUDE_GLOBAL_SNIPPET_PATH)
-    section = generate_weco_claude_section(snippet_content.strip())
-
-    existing_content = None
-    if CLAUDE_MD_PATH.exists():
-        try:
-            existing_content = read_from_path(CLAUDE_MD_PATH)
-        except Exception:
-            pass
-
-    existing_section = extract_weco_section(existing_content) if existing_content else None
-
-    if existing_section is not None and existing_section.strip() == section.strip():
-        console.print("[dim]~/.claude/CLAUDE.md already contains the latest Weco section.[/]")
-    else:
-        action = "updated" if existing_section is not None else "added"
-        console.print("\n[bold yellow]~/.claude/CLAUDE.md Update (Recommended)[/]")
-        console.print("Adding a Weco section to ~/.claude/CLAUDE.md makes Weco invocation more reliable.")
-        if Confirm.ask("Would you like to update ~/.claude/CLAUDE.md?", default=True):
-            upsert_weco_section(CLAUDE_MD_PATH, section)
-            console.print(f"[green]Weco section {action} in ~/.claude/CLAUDE.md.[/]")
-        else:
-            console.print("[yellow]Skipping ~/.claude/CLAUDE.md update.[/]")
-            console.print(f"[dim]You can manually add the Weco section to {CLAUDE_MD_PATH}[/]")
-
     console.print("\n[bold green]Setup complete![/]")
     if local_path:
         console.print(f"[dim]Skill copied from: {local_path}[/]")
     console.print(f"[dim]Skill installed at: {WECO_SKILL_DIR}[/]")
-    console.print(f"[dim]Global CLAUDE.md at: {CLAUDE_MD_PATH}[/]")
 
 
 def setup_cursor(console: Console, local_path: pathlib.Path | None = None) -> None:
     """Set up Weco rules for Cursor."""
     console.print("[bold blue]Setting up Weco for Cursor...[/]\n")
 
-    # Cursor setup is intentionally "editor-config-centric":
-    # - Install/copy the skill into Cursor's skills directory (so we can read snippets).
-    # - The behavior change is controlled by `~/.cursor/rules/weco.mdc`, which is *global*
-    #   editor state (not part of the installed skill folder).
-    # - Because users may have customized that file, we:
-    #   1) compute desired content from the snippet
-    #   2) check if it is already up to date
-    #   3) prompt before creating/updating it
     install_skill(CURSOR_WECO_SKILL_DIR, console, local_path)
 
-    snippet_content = read_from_path(CURSOR_RULES_SNIPPET_PATH)
-    mdc_content = generate_cursor_mdc_content(snippet_content.strip())
-
-    # Check if already up to date
-    existing_content = None
-    if CURSOR_WECO_RULES_PATH.exists():
-        try:
-            existing_content = read_from_path(CURSOR_WECO_RULES_PATH)
-        except Exception:
-            pass
-
-    if existing_content is not None and existing_content.strip() == mdc_content.strip():
-        console.print("[dim]weco.mdc already contains the latest Weco rules.[/]")
-        console.print("\n[bold green]Setup complete![/]")
-        console.print(f"[dim]Rules file at: {CURSOR_WECO_RULES_PATH}[/]")
-        return
-
-    # Prompt user for creation/update
-    if existing_content is not None:
-        console.print("\n[bold yellow]weco.mdc Update[/]")
-        console.print("The Weco rules file can be updated to the latest version.")
-        if not Confirm.ask("Would you like to update weco.mdc?", default=True):
-            console.print("\n[yellow]Skipping weco.mdc update.[/]")
-            console.print(f"[dim]Skill installed but rules not configured. Create manually at {CURSOR_WECO_RULES_PATH}[/]")
-            return
-    else:
-        console.print("\n[bold yellow]weco.mdc Creation[/]")
-        console.print("To enable Weco optimization rules, we can create a weco.mdc file.")
-        if not Confirm.ask("Would you like to create weco.mdc?", default=True):
-            console.print("\n[yellow]Skipping weco.mdc creation.[/]")
-            console.print(f"[dim]Skill installed but rules not configured. Create manually at {CURSOR_WECO_RULES_PATH}[/]")
-            return
-
-    write_to_path(CURSOR_WECO_RULES_PATH, mdc_content, mkdir=True)
-    console.print("[green]weco.mdc created successfully.[/]")
-
     console.print("\n[bold green]Setup complete![/]")
     if local_path:
         console.print(f"[dim]Skill copied from: {local_path}[/]")
     console.print(f"[dim]Skill installed at: {CURSOR_WECO_SKILL_DIR}[/]")
-    console.print(f"[dim]Rules file at: {CURSOR_WECO_RULES_PATH}[/]")
 
 
 # =============================================================================