start-session

Creates a session notes folder, registers it in active-sessions.json, and rebases the git branch.

6|1|Updated Jun 6, 2026
One-click install
npx skills add https://github.com/t-mercier/ai-agents-orchestrator --skill start-session-t-mercier
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: start-session
Source: https://github.com/t-mercier/ai-agents-orchestrator/tree/main/skills/start-session
Command: npx skills add https://github.com/t-mercier/ai-agents-orchestrator --skill start-session-t-mercier

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Starting a new work session usually means manually creating a notes folder, tracking which terminal belongs to which task, and remembering to sync the git branch. This Skill automates that bootstrap so every session begins with a structured notes.md, a registered entry in the session registry, and an up-to-date branch. ## Core Features & Use Cases - Workspace bootstrap: Creates the session folder and a notes.md template with goal, decisions, open questions, and next steps under the category's configured directory. - Session registration and naming: Writes the session into ~/.claude/active-sessions.json and renames the terminal session to CATEGORY | NAME | TICKET for dashboard visibility. - Collision guard: Detects when the current terminal is already bound to a different active session and offers to create the new workspace unbound instead of hijacking the existing session. - Conditional git sync: Only when the folder sits inside a git repo, fetches and rebases the branch onto origin without ever creating checkouts or worktrees. - Use Case: Run /start-session FEAT PROJ-123 add-login-flow to spin up a notes workspace for a new feature ticket, register it in the AI Agents Orchestrator dashboard, and rebase your branch in one step. ## Quick Start Ask the assistant to start a new session for a category and ticket, for example by typing /start-session FEAT PROJ-123 short-name.

Frequently Asked Questions about start-session

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I start a new Claude Code session with notes tracking?

Run /start-session with a category and ticket or name, such as /start-session FEAT PROJ-123 add-login. The skill creates the notes folder and notes.md, registers the session in active-sessions.json, and renames the terminal session.

What happens if the session folder already exists?

The skill aborts without overwriting anything and tells you to use /restart-session with the folder name to reopen the existing workspace in the current session.

Does start-session create a git branch or worktree?

No. It never creates checkouts or worktrees; the folder holds notes only. If the folder is inside a git repo, it fetches and rebases the current branch onto origin, aborting safely on conflicts.

Why does start-session warn about hijacking an active session?

If the current terminal is already bound to a different active session, proceeding would re-point that session ID and detach the existing work from the dashboard. The collision guard asks whether to create the new workspace unbound or re-bind the terminal.

Can I run start-session in plan mode?

No. The skill writes files, so it stops immediately when plan mode is active and asks you to switch to auto mode before re-running the command.