Skip to content

Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows

Consolidate intro content into quickstart for streamlined onboarding

Maximilian Roos0619ef8ffb9d
diff --git a/docs/content/concepts.md b/docs/content/concepts.md
index 950965f81..f91915cba 100644
--- a/docs/content/concepts.md
+++ b/docs/content/concepts.md
@@ -1,6 +1,6 @@
+++
title = "Concepts"
-weight = 3
+weight = 2
+++
## Why git worktrees?
@@ -95,13 +95,3 @@ test result: ok. 18 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; fin
- **Lifecycle hooks**: Run commands on create, start, pre-merge, post-merge
- **Unified status**: See changes, commits, CI status across all worktrees
- **Safe cleanup**: Validates changes are merged before deleting branches
-
-## Worktree addressing
-
-Worktrunk uses **path-first lookup** when resolving arguments:
-
-1. Compute the expected path for the argument (using the configured path template)
-2. If a worktree exists at that path, use it (regardless of what branch it's on)
-3. Otherwise, treat the argument as a branch name
-
-This means `wt switch foo` will switch to `repo.foo/` even if that worktree is on a different branch.
diff --git a/docs/content/intro.md b/docs/content/intro.md
deleted file mode 100644
index 80b104fed..000000000
--- a/docs/content/intro.md
+++ /dev/null
@@ -1,17 +0,0 @@
-+++
-title = "Intro"
-weight = 1
-+++
-
-Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows. Git worktrees give each agent an isolated branch and directory; Worktrunk adds branch-based navigation, unified status, and lifecycle hooks. The goal is to make spinning up a new AI "developer" for a task feel as routine as `git switch`.
-
-![Worktrunk Demo](/wt-demo.gif)
-
-## Getting Started
-
-We recommend:
-
-- **Start with Worktrunk as a simpler & better `git worktree`**: create, navigate, list, and clean up git worktrees with ease
-- **Later use the more advanced features if they resonate**: [LLM commit messages](/llm-commits/), [local merging with CI-like checks](/concepts/#local-merging-with-wt-merge), [fzf-like worktree picker](/commands/#wt-select), [Claude Code integration](/advanced/#claude-code-integration), and more
-
-Ready? Head to the [Quick Start](/quickstart/).
diff --git a/docs/content/quickstart.md b/docs/content/quickstart.md
index 243897c7f..bc191d6f5 100644
--- a/docs/content/quickstart.md
+++ b/docs/content/quickstart.md
@@ -1,8 +1,12 @@
+++
title = "Quick Start"
-weight = 2
+weight = 1
+++
+Worktrunk is a CLI for Git worktree management, designed for parallel AI agent workflows. Git worktrees give each agent an isolated branch and directory; Worktrunk adds branch-based navigation, unified status, and lifecycle hooks. The goal is to make spinning up a new AI "developer" for a task feel as routine as `git switch`.
+
+![Worktrunk Demo](/wt-demo.gif)
+
## Install
**Homebrew (macOS):**
@@ -83,4 +87,4 @@ Worktrunk checks if your changes are already on main before deleting the branch.
- Understand [why worktrees matter](/concepts/) and how Worktrunk improves on plain git
- Set up [project hooks](/hooks/) for automated setup
-- Use [LLM commit messages](/llm-commits/) for auto-generated commits
+- Explore advanced features: [LLM commit messages](/llm-commits/), [local merging](/merge/), [fzf-like picker](/select/), [Claude Code integration](/advanced/#claude-code-integration)
diff --git a/docs/templates/index.html b/docs/templates/index.html
index 29b4a0658..ac4789e66 100644
--- a/docs/templates/index.html
+++ b/docs/templates/index.html
@@ -98,14 +98,9 @@
{% endblock toc %}
{% block content %}
-{# Display intro content directly on homepage #}
+{# Display quickstart content directly on homepage #}
{% set docs_section = get_section(path="_index.md") %}
-{% set intro = docs_section.pages | filter(attribute="slug", value="intro") | first %}
-<div class="heading-text">{{ intro.title }}</div>
-{{ intro.content | safe }}
-
-<div class="page-nav" style="justify-content: flex-end;">
- {% set quickstart = docs_section.pages | filter(attribute="slug", value="quickstart") | first %}
- <a href="{{ quickstart.permalink | safe }}">{{ quickstart.title }} →</a>
-</div>
+{% set quickstart = docs_section.pages | filter(attribute="slug", value="quickstart") | first %}
+<div class="heading-text">{{ quickstart.title }}</div>
+{{ quickstart.content | safe }}
{% endblock content %}