From 7763552db15870f4a727ab3ac76f714e250bbe59 Mon Sep 17 00:00:00 2001
From: Aly Raffauf <aly@aly.codes>
Date: Wed, 11 Feb 2026 08:18:23 -0500
Subject: [PATCH] add hinting for commands

---
 source/app.tsx     | 10 ++++++++++
 source/commands.ts |  8 ++++++++
 2 files changed, 18 insertions(+)

diff --git a/source/app.tsx b/source/app.tsx
index d26ddf1..e116aed 100644
--- a/source/app.tsx
+++ b/source/app.tsx
@@ -133,6 +133,16 @@ export default function App() {
 				</Text>
 				<TextInput value={input} onChange={setInput} onSubmit={handleSubmit} />
 			</Box>
+
+			{input &&
+				commands
+					.filter(c => c.prefix.startsWith(input))
+					.map(c => (
+						<Text key={c.prefix} dimColor>
+							{'  '}
+							{c.hint}
+						</Text>
+					))}
 		</Box>
 	);
 }
diff --git a/source/commands.ts b/source/commands.ts
index 48787b0..de07fb7 100644
--- a/source/commands.ts
+++ b/source/commands.ts
@@ -18,12 +18,14 @@ export type CommandContext = {
 };
 type Command = {
 	prefix: string;
+	hint: string;
 	run: (args: string, ctx: CommandContext) => Promise<void>;
 };
 
 export const commands: Command[] = [
 	{
 		prefix: 'done ',
+		hint: 'done <number>',
 		run: async (args, {api, tasks, setMessage, refresh}) => {
 			const num = Number.parseInt(args, 10);
 			const task = tasks[num - 1];
@@ -38,6 +40,7 @@ export const commands: Command[] = [
 	},
 	{
 		prefix: 'add ',
+		hint: 'add <task>',
 		run: async (args, {api, setMessage, refresh}) => {
 			await api.quickAddTask({text: args});
 			setMessage(`+ ${args}`);
@@ -46,6 +49,7 @@ export const commands: Command[] = [
 	},
 	{
 		prefix: 'refresh',
+		hint: 'refresh',
 		run: async (_args, {refresh, setMessage}) => {
 			await refresh();
 			setMessage('↻ refreshed');
@@ -53,6 +57,7 @@ export const commands: Command[] = [
 	},
 	{
 		prefix: 'project ',
+		hint: 'project <project>',
 		run: async (args, {projects, setMessage, setView}) => {
 			const projectId = [...projects.entries()].find(
 				([, n]) => n.toLowerCase() === args.toLowerCase(),
@@ -68,6 +73,7 @@ export const commands: Command[] = [
 
 	{
 		prefix: 'today',
+		hint: 'today',
 		run: async (_args, {setView, setMessage}) => {
 			setView({type: 'filter', query: 'today'});
 			setMessage('→ today');
@@ -76,6 +82,7 @@ export const commands: Command[] = [
 
 	{
 		prefix: 'home',
+		hint: 'home',
 		run: async (_args, {setView, setMessage, homeFilter}) => {
 			setView({type: 'filter', query: homeFilter});
 			setMessage('→ home');
@@ -84,6 +91,7 @@ export const commands: Command[] = [
 
 	{
 		prefix: 'quit',
+		hint: 'quit',
 		run: async (_args, {exit}) => {
 			exit();
 		},
-- 
2.51.2