feat: version display, gateway mismatch detection, doctor VM conflict check, branding cleanup

- Show binary version in TUI title bar (sciClaw v{version})
- Gateway writes status file on startup for version tracking
- TUI warns when gateway version mismatches binary (suppressed for dev builds)
- Doctor check detects host+VM Discord/Telegram gateway conflicts (fixes #72)
- Rebrand user-facing picoclaw references to sciclaw (error messages, help text, system prompt, workspace templates)
- Add `make app` target for quick dev build+run
- Add `sciclaw` to .gitignore, move announcement to docs/
- Update docs with host+VM conflict warning

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: drpedapati

.gitignore

@@ -8,6 +8,7 @@ build/
 *.dylib
 *.test
 *.out
+/sciclaw
 /picoclaw
 /picoclaw-test
 

Makefile

@@ -178,6 +178,10 @@ deps:
 	@$(GO) mod vendor
 	@echo "Dependencies updated and vendored"
 
+## app: Build and launch the TUI dashboard
+app: build
+	@$(BUILD_DIR)/$(PRIMARY_BINARY_NAME) app
+
 ## run: Build and run sciclaw (picoclaw-compatible)
 run: build
 	@$(BUILD_DIR)/$(PRIMARY_BINARY_NAME) $(ARGS)

cmd/picoclaw/doctor_cmd.go

@@ -15,6 +15,7 @@ import (
 	"strings"
 	"time"
 
+	"github.com/sipeed/picoclaw/cmd/picoclaw/tui"
 	"github.com/sipeed/picoclaw/pkg/auth"
 	"github.com/sipeed/picoclaw/pkg/config"
 	svcmgr "github.com/sipeed/picoclaw/pkg/service"
@@ -310,6 +311,9 @@ func runDoctor(opts doctorOptions) doctorReport {
 		add(c)
 	}
 
+	// Host+VM Discord conflict detection (issue #72).
+	add(checkHostVMChannelConflict(cfg))
+
 	// Optional: Homebrew outdated status (best-effort).
 	add(checkHomebrewOutdated())
 
@@ -521,6 +525,61 @@ func checkWorkspacePythonVenv(workspace string, opts doctorOptions) doctorCheck
 	}
 }
 
+// checkHostVMChannelConflict detects when both host and VM gateways are
+// running with the same channel enabled, which causes duplicate replies.
+func checkHostVMChannelConflict(hostCfg *config.Config) doctorCheck {
+	name := "gateway.host_vm_conflict"
+
+	if hostCfg == nil {
+		return doctorCheck{Name: name, Status: doctorSkip, Message: "no host config"}
+	}
+
+	// Quick check: is a VM even present and running?
+	vmState := tui.VMState()
+	if vmState != "Running" {
+		return doctorCheck{Name: name, Status: doctorSkip, Message: "no VM running"}
+	}
+
+	// Is the VM gateway service active?
+	if !tui.VMServiceActive() {
+		return doctorCheck{Name: name, Status: doctorOK, Message: "VM running but gateway not active"}
+	}
+
+	// Read VM config to check which channels are enabled.
+	vmCfgRaw, err := tui.VMCatFile("/home/ubuntu/.picoclaw/config.json")
+	if err != nil {
+		return doctorCheck{Name: name, Status: doctorSkip, Message: "cannot read VM config"}
+	}
+	var vmCfg struct {
+		Channels struct {
+			Discord  struct{ Enabled bool `json:"enabled"` } `json:"discord"`
+			Telegram struct{ Enabled bool `json:"enabled"` } `json:"telegram"`
+		} `json:"channels"`
+	}
+	if json.Unmarshal([]byte(vmCfgRaw), &vmCfg) != nil {
+		return doctorCheck{Name: name, Status: doctorSkip, Message: "cannot parse VM config"}
+	}
+
+	// Check for overlapping channels.
+	var conflicts []string
+	if hostCfg.Channels.Discord.Enabled && vmCfg.Channels.Discord.Enabled {
+		conflicts = append(conflicts, "Discord")
+	}
+	if hostCfg.Channels.Telegram.Enabled && vmCfg.Channels.Telegram.Enabled {
+		conflicts = append(conflicts, "Telegram")
+	}
+
+	if len(conflicts) == 0 {
+		return doctorCheck{Name: name, Status: doctorOK, Message: "no channel overlap between host and VM"}
+	}
+
+	return doctorCheck{
+		Name:    name,
+		Status:  doctorErr,
+		Message: fmt.Sprintf("%s enabled on both host and VM gateways — duplicate replies will occur; disable on one side or use separate bot tokens with non-overlapping routed channels", strings.Join(conflicts, ", ")),
+	}
+}
+
 func checkGatewayLog(telegramEnabled bool) doctorCheck {
 	home, err := os.UserHomeDir()
 	if err != nil {

cmd/picoclaw/main.go

@@ -21,6 +21,7 @@ import (
 	"time"
 
 	"github.com/chzyer/readline"
+	"github.com/sipeed/picoclaw/cmd/picoclaw/tui"
 	"github.com/sipeed/picoclaw/pkg/agent"
 	"github.com/sipeed/picoclaw/pkg/auth"
 	"github.com/sipeed/picoclaw/pkg/bus"
@@ -51,6 +52,7 @@ func init() {
 	// Strip leading "v" set by ldflags so format strings can add their own.
 	version = strings.TrimPrefix(version, "v")
 	agent.Version = version
+	tui.Version = version
 }
 
 const logo = "🔬"
@@ -260,7 +262,7 @@ func printHelp() {
 	fmt.Println("  doctor      Check deployment health and dependencies")
 	fmt.Println("  cron        Manage scheduled tasks")
 	fmt.Println("  routing     Manage channel->workspace routing and ACLs")
-	fmt.Println("  migrate     Migrate from OpenClaw to sciClaw (PicoClaw-compatible)")
+	fmt.Println("  migrate     Migrate from OpenClaw to sciClaw")
 	fmt.Println("  skills      Manage skills (install, list, remove)")
 	fmt.Println("  backup      Backup key sciClaw config/workspace files")
 	fmt.Println("  version     Show version information")
@@ -958,7 +960,7 @@ func migrateCmd() {
 
 func migrateHelp() {
 	commandName := invokedCLIName()
-	fmt.Println("\nMigrate from OpenClaw to sciClaw (PicoClaw-compatible)")
+	fmt.Println("\nMigrate from OpenClaw to sciClaw")
 	fmt.Println()
 	fmt.Printf("Usage: %s migrate [options]\n", commandName)
 	fmt.Println()
@@ -1222,6 +1224,17 @@ func gatewayCmd() {
 			"skills_available": skillsInfo["available"],
 		})
 
+	// Write gateway status file for TUI version mismatch detection.
+	gwHome, _ := os.UserHomeDir()
+	gatewayStatusPath := filepath.Join(gwHome, ".picoclaw", "gateway.status.json")
+	if statusJSON, err := json.Marshal(map[string]interface{}{
+		"version":    version,
+		"pid":        os.Getpid(),
+		"started_at": time.Now().UTC().Format(time.RFC3339),
+	}); err == nil {
+		_ = os.WriteFile(gatewayStatusPath, statusJSON, 0644)
+	}
+
 	// Setup cron tool and service
 	cronService := setupCronTool(agentLoop, msgBus, cfg.WorkspacePath(), cfg.Agents.Defaults.RestrictToWorkspace)
 
@@ -1342,6 +1355,7 @@ func gatewayCmd() {
 	}
 	agentLoop.Stop()
 	channelManager.StopAll(ctx)
+	_ = os.Remove(gatewayStatusPath)
 	fmt.Println("✓ Gateway stopped")
 }
 
@@ -2278,7 +2292,7 @@ func skillsHelp() {
 	fmt.Println()
 	fmt.Println("Examples:")
 	fmt.Printf("  %s skills list\n", commandName)
-	fmt.Printf("  %s skills install sipeed/picoclaw-skills/weather\n", commandName)
+	fmt.Printf("  %s skills install drpedapati/sciclaw-skills/weather\n", commandName)
 	fmt.Printf("  %s skills install-builtin\n", commandName)
 	fmt.Printf("  %s skills list-builtin\n", commandName)
 	fmt.Printf("  %s skills remove weather\n", commandName)
@@ -2307,7 +2321,7 @@ func skillsInstallCmd(installer *skills.SkillInstaller) {
 	if len(os.Args) < 4 {
 		commandName := invokedCLIName()
 		fmt.Printf("Usage: %s skills install <github-repo>\n", commandName)
-		fmt.Printf("Example: %s skills install sipeed/picoclaw-skills/weather\n", commandName)
+		fmt.Printf("Example: %s skills install drpedapati/sciclaw-skills/weather\n", commandName)
 		return
 	}
 

cmd/picoclaw/tui/model.go

@@ -10,6 +10,9 @@ import (
 	"github.com/charmbracelet/lipgloss"
 )
 
+// Version is set by main.init() before the TUI launches.
+var Version string
+
 // Tab logical IDs — stable regardless of which tabs are visible.
 const (
 	tabHome     = 0
@@ -446,11 +449,22 @@ func (m Model) View() string {
 	var b strings.Builder
 
 	// Header
-	title := "🦞🧪 sciClaw Control Center"
+	ver := Version
+	if ver == "" {
+		ver = "dev"
+	}
+	title := fmt.Sprintf("🦞🧪 sciClaw v%s", ver)
 	if m.exec.Mode() == ModeVM {
-		title = "🦞🧪 sciClaw VM Control Center"
+		title = fmt.Sprintf("🦞🧪 sciClaw VM v%s", ver)
 	}
 	header := lipgloss.NewStyle().Bold(true).Foreground(colorAccent).Render(title)
+	if m.snapshot != nil && m.snapshot.GatewayVersion != "" &&
+		m.snapshot.GatewayVersion != ver &&
+		m.snapshot.ServiceRunning &&
+		ver != "dev" && m.snapshot.GatewayVersion != "dev" {
+		mismatch := fmt.Sprintf("  ⚠ Gateway running v%s — restart service to update", m.snapshot.GatewayVersion)
+		header += lipgloss.NewStyle().Foreground(colorWarning).Render(mismatch)
+	}
 	b.WriteString(header)
 	b.WriteString("\n")
 

cmd/picoclaw/tui/snapshot.go

@@ -19,6 +19,8 @@ type VMSnapshot struct {
 
 	// Agent version
 	AgentVersion string
+	// Gateway version from ~/.picoclaw/gateway.status.json
+	GatewayVersion string
 
 	// Config/workspace state
 	ConfigExists    bool
@@ -139,12 +141,13 @@ func collectVMSnapshot(exec Executor) VMSnapshot {
 	var cfgRaw, authRaw, hostCfgRaw string
 	var cfgErr, authErr, hostCfgErr error
 
-	wg.Add(5)
+	wg.Add(6)
 	go func() { defer wg.Done(); vmInfo = GetVMInfo() }()
 	go func() { defer wg.Done(); cfgRaw, cfgErr = exec.ReadFile(exec.ConfigPath()) }()
 	go func() { defer wg.Done(); authRaw, authErr = exec.ReadFile(exec.AuthPath()) }()
 	go func() { defer wg.Done(); hostCfgRaw, hostCfgErr = hostConfigRaw() }()
 	go func() { defer wg.Done(); snap.AgentVersion = exec.AgentVersion() }()
+	go func() { defer wg.Done(); snap.GatewayVersion = readGatewayVersion(exec) }()
 	wg.Wait()
 
 	snap.State = vmInfo.State
@@ -215,10 +218,11 @@ func collectLocalSnapshot(exec Executor) VMSnapshot {
 	var cfgRaw, authRaw string
 	var cfgErr, authErr error
 
-	wg.Add(3)
+	wg.Add(4)
 	go func() { defer wg.Done(); cfgRaw, cfgErr = exec.ReadFile(exec.ConfigPath()) }()
 	go func() { defer wg.Done(); authRaw, authErr = exec.ReadFile(exec.AuthPath()) }()
 	go func() { defer wg.Done(); snap.AgentVersion = exec.AgentVersion() }()
+	go func() { defer wg.Done(); snap.GatewayVersion = readGatewayVersion(exec) }()
 	wg.Wait()
 
 	// Parse config.
@@ -262,6 +266,21 @@ func collectLocalSnapshot(exec Executor) VMSnapshot {
 	return snap
 }
 
+func readGatewayVersion(exec Executor) string {
+	path := filepath.Join(filepath.Dir(exec.ConfigPath()), "gateway.status.json")
+	data, err := os.ReadFile(path)
+	if err != nil {
+		return ""
+	}
+	var status struct {
+		Version string `json:"version"`
+	}
+	if json.Unmarshal(data, &status) != nil {
+		return ""
+	}
+	return status.Version
+}
+
 func providerState(prov providerJSON, cred authCredJSON) string {
 	if strings.TrimSpace(prov.APIKey) != "" {
 		return "ready"