Cosine for VS Code

Bring your AI coding teammate (Genie) into VS Code. Preview changes live, open diffs with one click, and stay in flow—no manual setup.

• Website: https://cosine.sh
• CLI: https://cosine.sh/cli

Why Cosine in VS Code

• Work where you code: stay in your editor, keep your shortcuts, keep your theme.
• Understand changes before they land: preview diffs and jump straight to files.
• Minimal friction: the extension auto‑connects to the CLI and streams updates in real time.

Features

• ✦ Cosine Changes: live preview of proposed edits, grouped by file
• One‑click: open files or full diffs directly from the Explorer
• Status bar: connection indicator and quick access to the CLI terminal
• Smart auto‑open: optionally opens a diff when a coding stream completes
• Zero config: auto‑starts bridge/CLI based on settings

How this levels up the CLI for VS Code users

• Visual change stream: see pending edits in a live tree with inline previews—not just terminal text.
• Immediate navigation: click once to open the right file or a focused diff; no path hunting.
• Editor‑native controls: Command Palette actions, status bar connection, and your usual keyboard shortcuts.
• Context‑aware workspace: honors multi‑root workspaces and the currently active window; opens files in the project you’re working in.
• Smart lifecycle: auto‑start bridge/CLI, auto‑reconnect, optional auto‑open of the final diff to review the session.
• Safer apply flow: review changes before applying; nothing is written until you confirm.
• Integrated logging: “Output → Cosine” and the “Cosine” terminal make troubleshooting straightforward.
• Customizable: CLI path and args, auto‑start behaviors, and diff auto‑open are all configurable.

Requirements

• Cosine CLI installed and available on PATH (cos --version)
• An open project folder in VS Code
• macOS or Linux (Windows support coming — see https://cosine.sh/cli)

Installation

1. Install the Cosine CLI: https://cosine.sh/cli
2. Verify install: cos --version
3. Install the VS Code extension (this repo’s build or Marketplace when available).
4. Open a project in VS Code.

Quick start

1. Open a project in VS Code.
2. Reload the window; the “Cosine” terminal starts and runs cos.
3. Watch “✦ Cosine Changes” in the Explorer to preview updates and open diffs.
4. Apply changes when ready.

Tip: Logs are under “Output” → “Cosine”.

How it works

• The extension starts a VS Code ↔ CLI bridge and monitors the CLI session.
• Genie (via the CLI) streams proposed code edits.
• The Explorer view shows a live tree of incoming changes with file‑level previews.
• You remain in control: choose when to open, inspect, and apply diffs.

Commands

Run from the Command Palette:

• Cosine: Start VS Code Bridge — cosine.startBridge
• Cosine: Start CLI — cosine.startCli
• Cosine: Restart CLI — cosine.restartCli
• Cosine: Focus CLI Terminal — cosine.focusCliTerminal

Settings

• cosine.cli.autoStart — start the “Cosine” terminal and run the CLI on startup (default: true)
• cosine.cli.focusOnStart — focus the terminal when starting the CLI (default: true)
• cosine.cli.path — path to the CLI binary (default: cos)
• cosine.cli.args — extra CLI arguments (default: [])
• cosine.bridge.autoStart — start the VS Code ↔ CLI bridge automatically (default: true)
• cosine.diff.autoOpenOnStopStreaming — open a diff when a coding stream ends (default: true)

Troubleshooting

• “Cosine” terminal doesn’t start
  • Open a workspace folder.
  • Check cos is on your PATH (cos --version).
  • If needed, set cosine.cli.path to the absolute path of the CLI.
• Connection seems idle
  • Open “Output” → “Cosine” for logs.
  • Run “Cosine: Start CLI” or “Cosine: Start VS Code Bridge”.
• On Windows
  • CLI support is coming; track updates at https://cosine.sh/cli.

FAQ

• Does this modify files automatically?
  • No. Genie streams proposed edits. You choose when to open diffs and apply changes.
• Can I pass custom CLI flags?
  • Yes. Use cosine.cli.args (e.g., ["--verbose"]).
• Where are logs?
  • “Output” → “Cosine” and the “Cosine” terminal.

Security and privacy

• Changes are previewed before application; nothing is auto‑written.
• The extension communicates locally with the CLI; see CLI docs for network behavior.
• For enterprise questions, contact https://cosine.sh/contact.

Status

Pre‑release, actively developed. We’re focused on making the CLI experience feel native in VS Code.

Contributing

Issues and feature requests are welcome:

• https://github.com/cosineai/vscode/issues

License

See LICENSE.txt (included).