diff --git a/packages/app/src/runtime/i18n/en.ts b/packages/app/src/runtime/i18n/en.ts
index e04f1d5082d..ca8dd17bbb7 100644
--- a/packages/app/src/runtime/i18n/en.ts
+++ b/packages/app/src/runtime/i18n/en.ts
@@ -907,6 +907,11 @@ export const dict = {
"settings.timeline.row.backgroundActivity.left": "Left",
"settings.timeline.row.backgroundActivity.center": "Center",
"settings.timeline.row.backgroundActivity.right": "Right",
+ "settings.timeline.row.width.title": "Timeline width",
+ "settings.timeline.row.width.description": "Narrower lines are easier to scan. Wider lines show more at once",
+ "settings.timeline.row.width.focused": "Focused",
+ "settings.timeline.row.width.comfortable": "Comfortable",
+ "settings.timeline.row.width.wide": "Wide",
"settings.timeline.detail": "Timeline detail",
"settings.timeline.description": "Choose how much detail appears in the session timeline.",
"settings.timeline.summary": "{{preset}}:",
diff --git a/packages/app/src/settings/general/general.tsx b/packages/app/src/settings/general/general.tsx
index 4f81767f615..b7a3e723890 100644
--- a/packages/app/src/settings/general/general.tsx
+++ b/packages/app/src/settings/general/general.tsx
@@ -9,6 +9,7 @@ import { ExtensionSettingsSections } from "@/runtime/extension/settings-page-vie
import {
type BackgroundActivity,
type FollowUpBehavior,
+ type TimelineWidth,
type WorkspaceDefaultDestination,
useSettings,
} from "@/settings/model"
@@ -167,6 +168,35 @@ const BackgroundActivitySetting = () => {
)
}
+const TimelineWidthSetting = () => {
+ const language = useLanguage()
+ const settings = useSettings()
+ const options = createMemo((): { value: TimelineWidth; label: string }[] => [
+ { value: "focused", label: language.t("settings.timeline.row.width.focused") },
+ { value: "comfortable", label: language.t("settings.timeline.row.width.comfortable") },
+ { value: "wide", label: language.t("settings.timeline.row.width.wide") },
+ ])
+
+ return (
+
+
+ )
+}
+
const LanguageSetting = () => {
const language = useLanguage()
@@ -295,6 +325,7 @@ export const SettingsGeneral: Component = () => {
onChange={settings.general.setTimelineDetail}
/>
+
{
showCustomAgents: false,
showTurnDiffs: false,
backgroundActivity: "left",
+ timelineWidth: "comfortable",
generatedUI: true,
newIcons: false,
mobileTitlebarPosition: "top",
@@ -132,6 +133,7 @@ describe("settings schema", () => {
reasoningMode: 3,
followUpBehavior: "invalid",
backgroundActivity: "invalid",
+ timelineWidth: "invalid",
},
appearance: { fontSize: "large", mono: "Custom Mono", tabLayout: "vertical", showProjectName: true },
permissions: { autoApprove: true, autoApproveProjects: { on: true, off: false, bad: "yes" } },
@@ -147,6 +149,7 @@ describe("settings schema", () => {
timelineDetail: timelinePresets[2].value,
followUpBehavior: "steer",
backgroundActivity: "left",
+ timelineWidth: "comfortable",
})
expect(settings.appearance).toEqual({
fontSize: 14,
diff --git a/packages/app/src/settings/model.tsx b/packages/app/src/settings/model.tsx
index 5d09bb3528c..b40ce1cc7c0 100644
--- a/packages/app/src/settings/model.tsx
+++ b/packages/app/src/settings/model.tsx
@@ -19,6 +19,8 @@ export type FollowUpBehavior = Settings["general"]["followUpBehavior"]
export type BackgroundActivity = Settings["general"]["backgroundActivity"]
+export type TimelineWidth = Settings["general"]["timelineWidth"]
+
export type TabLayout = Settings["appearance"]["tabLayout"]
export type ReduceMotion = Settings["appearance"]["reduceMotion"]
@@ -124,6 +126,7 @@ const generalSchema = Persistence.struct({
showCustomAgents: Schema.Boolean,
showTurnDiffs: Schema.Boolean,
backgroundActivity: Schema.Literals(["off", "left", "center", "right"]),
+ timelineWidth: Schema.Literals(["focused", "comfortable", "wide"]),
// Lets agents render generated UI in the timeline; an experiment users can turn off.
generatedUI: Schema.Boolean,
// The "New icons" design experiment, off until it ships.
@@ -294,6 +297,7 @@ export const defaultSettings: Settings = {
showCustomAgents: false,
showTurnDiffs: false,
backgroundActivity: "left",
+ timelineWidth: "comfortable",
generatedUI: true,
newIcons: false,
mobileTitlebarPosition: "top",
@@ -354,6 +358,14 @@ export const { use: useSettings, provider: SettingsProvider } = createSimpleCont
document.documentElement.dataset.motion = reduce ? "reduce" : "full"
})
+ const timelineWidth = withFallback(() => store.general?.timelineWidth, defaultSettings.general.timelineWidth)
+
+ // The session column's width token keys off this attribute, so every surface sharing it follows the setting.
+ createEffect(() => {
+ if (typeof document === "undefined") return
+ document.documentElement.dataset.timelineWidth = timelineWidth()
+ })
+
const autoApproveDefault = withFallback(
() => store.permissions?.autoApprove,
defaultSettings.permissions.autoApprove,
@@ -388,6 +400,10 @@ export const { use: useSettings, provider: SettingsProvider } = createSimpleCont
setBackgroundActivity(value: BackgroundActivity) {
setStore("general", "backgroundActivity", value)
},
+ timelineWidth,
+ setTimelineWidth(value: TimelineWidth) {
+ setStore("general", "timelineWidth", value)
+ },
generatedUI: withFallback(() => store.general?.generatedUI, defaultSettings.general.generatedUI),
setGeneratedUI(value: boolean) {
setStore("general", "generatedUI", value)
diff --git a/packages/app/src/settings/search-catalog.ts b/packages/app/src/settings/search-catalog.ts
index b601dd92521..5e6a0132289 100644
--- a/packages/app/src/settings/search-catalog.ts
+++ b/packages/app/src/settings/search-catalog.ts
@@ -76,6 +76,14 @@ export const clientSettings: Entry[] = [
section: "settings.timeline.title",
keywords: "capsule panel subagent shell background activity position alignment hidden left center right",
},
+ {
+ tab: "general",
+ label: "settings.timeline.row.width.title",
+ description: "settings.timeline.row.width.description",
+ target: "settings-timeline-width",
+ section: "settings.timeline.title",
+ keywords: "column line length measure narrow focused comfortable wide readability",
+ },
{
tab: "general",
label: "settings.timeline.row.turnDiffs.title",
diff --git a/packages/ui/src/styles/tailwind/index.css b/packages/ui/src/styles/tailwind/index.css
index 58ef044caff..a463141654a 100644
--- a/packages/ui/src/styles/tailwind/index.css
+++ b/packages/ui/src/styles/tailwind/index.css
@@ -53,7 +53,8 @@
--container-6xl: 72rem;
--container-7xl: 80rem;
/* Shared by the session timeline, composer dock, and drop target so their edges stay aligned.
- The composer dock's 12px gutter leaves the design's 720px composer. */
+ The composer dock's 12px gutter leaves the design's 720px composer. The timeline width setting
+ overrides it below. */
--container-session: 744px;
--font-sans: var(--font-family-sans);
@@ -100,3 +101,13 @@
}
@import "./colors.css";
+
+/* With Inter at 14px, after the timeline's 24px side padding, these give about 66 characters per line
+ (the classic optimum for scanning prose); the 744px default gives about 105 and 1000px about 144. */
+:root[data-timeline-width="focused"] {
+ --container-session: 488px;
+}
+
+:root[data-timeline-width="wide"] {
+ --container-session: 1000px;
+}