aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authorJosh Rahm <rahm@josher.dev>2026-08-09 21:46:47 -0600
committerJosh Rahm <rahm@josher.dev>2026-08-09 21:46:47 -0600
commitd2eadb42ffde7f07b4c2d46efc3724d565ec8255 (patch)
tree47f363814f0df083b826c8ef475ccb12859a982a /README.md
downloadhobs.nvim-d2eadb42ffde7f07b4c2d46efc3724d565ec8255.tar.gz
hobs.nvim-d2eadb42ffde7f07b4c2d46efc3724d565ec8255.tar.bz2
hobs.nvim-d2eadb42ffde7f07b4c2d46efc3724d565ec8255.zip
Initial commit.
Diffstat (limited to 'README.md')
-rw-r--r--README.md24
1 files changed, 24 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b52c781
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# Hobs.nvim
+
+In English and in broader Northern European folklore a hob (short for hobgoblin)
+is a type of small household spirit. Hobs are often portrayed as helpful,
+domestic beings which quietly assist with chores around the house in exchange
+for small offerings or simply out of habit.
+
+In this project, the name is used metaphorically: small, invisible workers that
+live inside your editor, quietly helping with tasks while you continue your own
+work.
+
+## Little AI Helpers Which Work Along Side You In Neovim
+
+Most coding agents today follow a serial workflow. Typically something like:
+
+1. Human requests the AI do something
+1. The AI takes control of the repository
+1. Human waits for the AI to finish
+1. AI finishes and returns control of the repository.
+1. Human continues with the work
+
+`hobs.nvim` makes this flow concurrent. Now, the human can request an AI agent
+(A "hob"). The hob can do some simple task in the background, updating the live
+buffer as it goes along all while the human continues with his work.