8000 feat: name your assistant at first run (inkie and doctor), assistant pinned in the sidebar by simon-inkie · Pull Request #147 · simon-inkie/inkie-deck · GitHub
[go: up one dir, main page]

Skip to content

feat: name your assistant at first run (inkie and doctor), assistant pinned in the sidebar - #147

Merged
simon-inkie merged 10 commits into
mainfrom
feat/name-your-assistant
Nov 18, 2026
Merged

simon-inkie merged 10 commits into
mainfrom
feat/name-your-assistant

Conversation

@simon-inkie
@simon-inkie simon-inkie commented Nov 18, 2026 •
Copy link
Copy Markdown
Owner

What

first-run.sh names and creates two starter agents: an assistant (default inkie, the main orchestrator users talk to first) and a platform agent (default doctor, the "brain surgeon" that edits Deck, makes plugins and creates agents). The Deck sidebar pins the assistant above the agent list.

  • create-agent.sh gains --kind assistant|platform, --peer <name> and --check-name <name>; role briefs live in packages/base/templates/kinds/.
  • .peer is written before .kind, and .kind last, so an agent only counts as complete when its scaffold finished. Re-running is a no-op for existing agents; recovery binds to the surviving agent's saved name.
  • Names are validated before anything is created; marker writes refuse symlinks and directories.
  • Deck reads .kind through agent-kind.server.ts (regular files only) and pins the assistant; with no .kind the sidebar order is unchanged.

Spec: .specs/150-name-your-assistant/SPEC.md (issue text in ISSUE-TEXT.md). Issue: #150.

Out of scope

The conversational "what do you do?" first-run (next item, with the clean-machine install), workflow engine, intake, runs view, plugins, Brain switch.

Review and tests

  • Independent reviews: three rounds (Azure Sol x3, Aggy x1). All High and Medium findings fixed; remaining deferred items are in the SPEC Follow-ups (overlap lock for concurrent first-run, FIFO check/read race in the sidebar loader, a root path ending in a literal $& in the role brief).
  • Base tests 105 passed; Deck 2346 passed, 11 skipped, 0 failed. Typecheck, boundaries, leaks, licence, lib-version and dashes checks pass.
  • Not covered: a real model CLI run (tests use a stub claude), macOS.
  • check:leaks:messages reports 69 findings that are already on origin/main; none in these commits.

🤖 Generated with Claude Code

create-agent.sh gains --kind, --peer and --check-name. first-run.sh checks
both names before creating either, skips a kind that already exists, and
binds a recovery run to the saved peer name.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
…rding

Briefs now describe the assistant as the main orchestrator and the platform
agent as the brain surgeon that edits Deck, makes plugins and creates agents.
SPEC and issue text record the saved-peer warning, the origin qualification
and the next issue (conversational onboarding).

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
…reject flag-shaped names

.kind and .peer are written after both homes exist and never through a
symlink. Recovery stamps the surviving agent's actual name. --check-name
rejects a leading hyphen. first-run.sh survives bash -e. The shell loader's
pin mapping now has its own test.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
A refused .peer or .kind now leaves nothing behind, so a retry works. An
explicit empty name is invalid, --check-name rejects a second name, and the
refused-name replay in first-run.sh survives bash -e.

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
…oes it

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
simon-inkie and others added 2 commits November 18, 2026 10:30
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
Signed-off-by: Simon Dixon <simon-inkie@users.noreply.github.com>
@simon-inkie
simon-inkie merged commit 1be8145 into main Nov 18, 2026
4 checks passed