Skip to content

feat(cli): deprecation warnings for tunnel, rc, and REPL commands #900

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
tamirdresher merged 3 commits into from
Apr 8, 2026
Merged

feat(cli): deprecation warnings for tunnel, rc, and REPL commands #900

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
dd163c2
feat(cli): add deprecation warnings for tunnel, rc, and REPL commands
invalid-email-address Apr 7, 2026
34f150a
chore: add changeset for tunnel/rc/REPL deprecation warnings
invalid-email-address Apr 7, 2026
c481591
fix: shorten deprecation hint to fit 80-char UX gate
invalid-email-address Apr 8, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .changeset/deprecate-tunnel-rc-repl.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,5 @@
---
"@bradygaster/squad-cli": patch

Copilot AI Apr 7, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Changeset frontmatter uses double quotes around the package name. Other changesets in this repo consistently use single quotes (e.g. .changeset/fix-team-root-all-commands.md:2). Aligning to the established format avoids churn and keeps changesets consistent.

Suggested change
"@bradygaster/squad-cli": patch
'@bradygaster/squad-cli': patch

Copilot uses AI. Check for mistakes.
---

Add deprecation warnings for tunnel, rc, and REPL commands. The interactive shell (no-args), `squad start`, `squad start --tunnel`, `squad rc`, and `squad rc-tunnel` now emit yellow deprecation notices pointing users to the GitHub Copilot CLI. No behavior changes — all commands still work.
22 changes: 15 additions & 7 deletions packages/squad-cli/src/cli-entry.ts
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -150,7 +150,7 @@ async function main(): Promise<void> {
console.log(`\n${BOLD}squad${RESET} v${VERSION} — Add an AI agent team to any project\n`);
console.log(`Usage: squad [command] [options]\n`);
console.log(`Commands:`);
console.log(` ${BOLD}(default)${RESET} Launch interactive shell (no args)`);
console.log(` ${BOLD}(default)${RESET} Launch interactive shell (no args) ${YELLOW}[DEPRECATED]${RESET}`);
console.log(` Flags: --global (init in personal squad directory)`);
console.log(` ${BOLD}init${RESET} Initialize Squad (markdown-only, default)`);
console.log(` Flags: --sdk (SDK builder syntax)`);
Expand Down Expand Up @@ -209,12 +209,10 @@ async function main(): Promise<void> {
console.log(` Usage: import <file> [--force]`);
console.log(` ${BOLD}scrub-emails${RESET} Remove email addresses from Squad state files`);
console.log(` Usage: scrub-emails [directory] (default: .ai-team/)`);
console.log(` ${BOLD}start${RESET} Start Copilot with remote access from phone/browser`);
console.log(` ${BOLD}start${RESET} Start Copilot with remote access from phone/browser ${YELLOW}[DEPRECATED]${RESET}`);
console.log(` Usage: start [--tunnel] [--port <n>] [--command <cmd>]`);
console.log(` [copilot flags...]`);
console.log(` Examples: start --tunnel --yolo`);
console.log(` start --tunnel --model claude-sonnet-4`);
console.log(` start --tunnel --command "gh copilot"`);
console.log(` ${DIM}⚠ Deprecated: will be removed in a future release.${RESET}`);
console.log(` ${BOLD}nap${RESET} Context hygiene (compress, prune, archive .squad/ state)`);
console.log(` Usage: nap [--deep] [--dry-run]`);
console.log(` Flags: --deep (thorough cleanup), --dry-run (preview only)`);
Expand All @@ -239,12 +237,12 @@ async function main(): Promise<void> {
console.log(` Usage: personal init | list | add <name>`);
console.log(` --role <role> | remove <name>`);
console.log(` ${BOLD}cast${RESET} Show current session cast (project + personal agents)`);
console.log(` ${BOLD}rc${RESET} Start Remote Control bridge (phone/browser → Copilot)`);
console.log(` ${BOLD}rc${RESET} Start Remote Control bridge (phone/browser → Copilot) ${YELLOW}[DEPRECATED]${RESET}`);
console.log(` Usage: rc [--tunnel] [--port <n>] [--path <dir>]`);
console.log(` ${BOLD}copilot-bridge${RESET} Check Copilot ACP stdio compatibility`);
console.log(` ${BOLD}init-remote${RESET} Link project to remote team root (shorthand)`);
console.log(` Usage: init-remote <team-repo-path>`);
console.log(` ${BOLD}rc-tunnel${RESET} Check devtunnel CLI availability`);
console.log(` ${BOLD}rc-tunnel${RESET} Check devtunnel CLI availability ${YELLOW}[DEPRECATED]${RESET}`);
console.log(` ${BOLD}discover${RESET} List known squads and their capabilities`);
console.log(` ${BOLD}delegate${RESET} Create work in another squad`);
console.log(` Usage: delegate <squad-name> <description>`);
Expand Down Expand Up @@ -273,6 +271,8 @@ async function main(): Promise<void> {

// No args → launch interactive shell; whitespace-only arg → show help
if (rawCmd === undefined) {
console.log(`\n${YELLOW}⚠ DEPRECATED:${RESET} The interactive REPL shell is deprecated and will be removed in a future release.`);
console.log(` Use the GitHub Copilot CLI instead: ${BOLD}gh copilot${RESET} (squad.agent.md is picked up automatically)\n`);
// Fire-and-forget update check — non-blocking, never delays shell startup
import('./cli/self-update.js').then(m => m.notifyIfUpdateAvailable(VERSION)).catch(() => {});
const { runShell } = await lazyRunShell();
Expand Down Expand Up @@ -708,8 +708,13 @@ async function main(): Promise<void> {
}

if (cmd === 'start') {
console.log(`\n${YELLOW}⚠ DEPRECATED:${RESET} "squad start" is deprecated and will be removed in a future release.`);
console.log(` Use the GitHub Copilot CLI directly: ${BOLD}copilot${RESET} or ${BOLD}gh copilot${RESET}\n`);
const { runStart } = await import('./cli/commands/start.js');
const hasTunnel = args.includes('--tunnel');
if (hasTunnel) {
console.log(`${YELLOW}⚠ DEPRECATED:${RESET} --tunnel is deprecated and will be removed in a future release.\n`);
Comment on lines +711 to +716

Copilot AI Apr 7, 2026

Copy link

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The deprecation message suggests using copilot directly, which can be ambiguous in this repo (there is also a squad copilot subcommand) and may not be installed on all systems. Consider pointing users only to gh copilot (which is the documented default in several places) or explicitly clarifying what copilot refers to to avoid confusion.

Copilot uses AI. Check for mistakes.
}
const portIdx = args.indexOf('--port');
const port = (portIdx !== -1 && args[portIdx + 1]) ? parseInt(args[portIdx + 1]!, 10) : 0;
// Collect all remaining args to pass through to copilot
Expand Down Expand Up @@ -789,6 +794,8 @@ async function main(): Promise<void> {
}

if (cmd === 'rc' || cmd === 'remote-control') {
console.log(`\n${YELLOW}⚠ DEPRECATED:${RESET} "squad rc" is deprecated and will be removed in a future release.`);
console.log(` Use the GitHub Copilot CLI directly: ${BOLD}copilot${RESET} or ${BOLD}gh copilot${RESET}\n`);
const { runRC } = await import('./cli/commands/rc.js');
const hasTunnel = args.includes('--tunnel');
const portIdx = args.indexOf('--port');
Expand Down Expand Up @@ -823,6 +830,7 @@ async function main(): Promise<void> {
}

if (cmd === 'rc-tunnel') {
console.log(`\n${YELLOW}⚠ DEPRECATED:${RESET} "squad rc-tunnel" is deprecated and will be removed in a future release.\n`);
const { isDevtunnelAvailable } = await import('./cli/commands/rc-tunnel.js');
if (isDevtunnelAvailable()) {
console.log(`${GREEN}✓${RESET} devtunnel CLI is available`);
Expand Down
Loading