fix: add missing cmd/bodek entry point

- Create the CLI main package referenced by README/Makefile/.goreleaser
- Anchor the /bodek ignore pattern so cmd/bodek sources are tracked
- Make TestSpawnDefaultBinMissing deterministic by isolating PATH

Author: jkyberneees

.gitignore

@@ -1,6 +1,6 @@
 # Build artifacts
 /bin/
-bodek
+/bodek
 
 # Editor / OS noise
 .DS_Store

cmd/bodek/main.go

@@ -0,0 +1,97 @@
+// Command bodek is a beautiful terminal interface for the odek agent.
+// It launches (or attaches to) an odek serve instance and renders the agent's
+// live stream as a Bubble Tea TUI.
+package main
+
+import (
+	"flag"
+	"fmt"
+	"os"
+	"os/signal"
+	"syscall"
+
+	tea "github.com/charmbracelet/bubbletea"
+
+	"github.com/BackendStack21/bodek/internal/client"
+	"github.com/BackendStack21/bodek/internal/server"
+	"github.com/BackendStack21/bodek/internal/tui"
+)
+
+func main() {
+	if err := run(); err != nil {
+		fmt.Fprintln(os.Stderr, "bodek:", err)
+		os.Exit(1)
+	}
+}
+
+func run() error {
+	var (
+		url     = flag.String("url", "", "attach to an already-running odek serve URL (e.g. http://127.0.0.1:8080)")
+		sandbox = flag.Bool("sandbox", false, "run tool calls inside odek's Docker sandbox")
+		bin     = flag.String("odek-bin", "", "path to the odek binary to spawn (default: odek on PATH)")
+	)
+	flag.Usage = func() {
+		fmt.Fprintf(os.Stderr, "Usage: bodek [options] [-- <odek serve flags>]\n\n")
+		fmt.Fprintf(os.Stderr, "A terminal interface for the odek agent.\n\n")
+		fmt.Fprintf(os.Stderr, "Options:\n")
+		flag.PrintDefaults()
+		fmt.Fprintf(os.Stderr, "\nExamples:\n")
+		fmt.Fprintf(os.Stderr, "  bodek                               # spawn odek serve and start chatting\n")
+		fmt.Fprintf(os.Stderr, "  bodek --sandbox                     # spawn odek serve with Docker sandbox\n")
+		fmt.Fprintf(os.Stderr, "  bodek --url http://127.0.0.1:8080   # attach to a running odek serve\n")
+		fmt.Fprintf(os.Stderr, "  bodek -- --prompt-caching           # pass extra flags to odek serve\n")
+	}
+	flag.Parse()
+
+	extraArgs := flag.Args()
+
+	// Spawn or attach to the odek serve backend.
+	srv, err := server.Connect(server.Options{
+		URL:       *url,
+		Bin:       *bin,
+		Sandbox:   *sandbox,
+		ExtraArgs: extraArgs,
+		Stderr:    os.Stderr,
+	})
+	if err != nil {
+		return err
+	}
+	defer srv.Stop()
+
+	// Dial the WebSocket and start streaming events.
+	cl, err := client.Dial(srv.WSURL, srv.Origin, srv.BaseURL, srv.Token)
+	if err != nil {
+		return err
+	}
+	defer cl.Close()
+
+	cwd, err := os.Getwd()
+	if err != nil {
+		cwd = "."
+	}
+
+	// Gracefully shutdown on SIGINT/SIGTERM so the server gets a clean exit.
+	setupSignalHandler(srv, cl)
+
+	model := tui.New(cl, tui.Options{
+		Sandbox: *sandbox,
+		CWD:     cwd,
+	})
+
+	p := tea.NewProgram(model, tea.WithAltScreen(), tea.WithMouseCellMotion())
+	if _, err := p.Run(); err != nil {
+		return fmt.Errorf("TUI exited: %w", err)
+	}
+	return nil
+}
+
+func setupSignalHandler(srv *server.Conn, cl *client.Client) {
+	ch := make(chan os.Signal, 1)
+	signal.Notify(ch, os.Interrupt, syscall.SIGTERM)
+	go func() {
+		<-ch
+		_ = cl.Close()
+		srv.Stop()
+		os.Exit(0)
+	}()
+}

internal/server/server_internal_test.go

@@ -3,6 +3,7 @@ package server
 import (
 	"net/http"
 	"net/http/httptest"
+	"os"
 	"os/exec"
 	"testing"
 	"time"
@@ -47,6 +48,10 @@ func TestStopInterruptsLongProcess(t *testing.T) {
 
 func TestSpawnDefaultBinMissing(t *testing.T) {
 	// Empty Bin defaults to "odek"; absent from PATH here → LookPath error.
+	// Isolate PATH so the test is deterministic even when odek is installed.
+	oldPath := os.Getenv("PATH")
+	defer os.Setenv("PATH", oldPath)
+	os.Setenv("PATH", "")
 	c := &Conn{}
 	if err := c.spawn(Options{Bin: ""}, "127.0.0.1:0"); err == nil {
 		t.Error("expected default-bin lookup to fail")