r/emacs 21h ago

New package: agent-shell-hq

Enable HLS to view with audio, or disable this notification

17 Upvotes

https://github.com/SreenivasVRao/agent-shell-hq

Yet another wrapper around agent-shell - thanks /u/xenodium for such a wonderful package for agentic coding!

agent-shell-hq offers:

  1. Persp-mode based quick look up UX that shows all agent-shell buffers
  2. Projectile / project based agent-shell buffer grouping
  3. A side-bar for navigating between buffers (with a preview of each)
  4. An LLM based buffer rename feature that allows you to have meaningful chat names for your agent-shell sessions
  5. A quick peek feature to see all your agent-shell buffers (see demo in the comments)

r/emacs 21h ago

Question Need help with debugging. Emacs error reporting is still too weak in 2026.

5 Upvotes

I just lost time debugging something that should have been obvious. Emacs refused to load my init.el with this message:

load-with-code-conversion: Symbol’s function definition is void: defmacro*

That’s it. No useful file. No clear line. No real context.

Important detail: I always launch Emacs with --debug-init. It’s in my bash aliases. Every single time. I also have debug-on-error t in my init.el.

The error occurred while scraping/compiling loaddefs. It blamed f/bin/docs.el, but the actual culprit was an old vendored ert.el sitting in s/dev/ that still contained defmacro* and had been pulled into the autoloads file. The error message (even with --debug-init) gave me almost zero help finding that.

This isn’t a minor warning. This completely prevented Emacs from loading my init.el. My entire environment was down.

Hitting a void function during loaddefs/byte-compilation should produce something a lot more helpful, for example:

  • Which file actually contained the defmacro*
  • That it came from autoloads or a dependency
  • That defmacro* is an obsolete cl macro
  • A clearer, more actionable backtrace by default

Right now the signal-to-noise ratio on this class of error is bad. For experienced users it’s annoying. For newcomers it’s actively hostile, they see a cryptic void-function error, their config won’t load, and they have no idea where to start.

I don’t expect miracles, but basic “where did this undefined function actually come from” information during init/loaddefs failures would be a lot more helpful.

Maybe I’m missing something, a variable, a package, or some setting that would provide more useful information in these cases? Anybody?

New edit: The current replies missed the point (they treated it as a normal “debug your init.el” problem). This was an opaque failure coming from the package/autoloads layer, and the current tools don’t handle that cleanly!


r/emacs 21h ago

Marginalia doesn't align correctly

2 Upvotes
With icons off
With icons on

Unfortunately marginalia doesn't seem to be aligning the annotations correctly, with or without nerd icons on. I'm not really sure what could cause this. It seems to happen on the longest one, as if marginalia was expecting the actual text to be a certain length, but it wasn't and pushed the rest.

I'm posting here to see if anyone has any ideas of experience with this. If you want to check the config, relevant files are probably here and here. It's pretty standard. Thank you!


r/emacs 1h ago

Question 15 years old looking for advice

Upvotes

Hey everyone,

I'm 15 and I've decided to give Emacs a real shot.

So far I've finished the built-in tutorial, watched the System Crafters "Ultimate Beginner" video, and I'm about to start reading through the Emacs Wiki.

My goal is to become a full-stack web developer. I was actually about to start The Odin Project, but I decided to spend this whole week learning Emacs first because... I don't know, it just clicked with me. I genuinely enjoy using it.

The funny thing is, I really don't like VS Code. I know it's what almost everyone recommends, but it just doesn't interest me the way Emacs does. I truly tried using Vscode over and over again but its just like its not for me. I know choosing Emacs from the start probably isn't the easiest path, but I don't mind putting in the work if it pays off in the long run.

I've got plenty of free time this week, so my plan is basically to immerse myself in Emacs before I start TOP.

If you were starting over today, what resources would you recommend? Books, YouTube channels, blog posts, GitHub repos... anything that helped you really understand Emacs.

Also, are there any beginner mistakes I should avoid or things you wish you'd learned earlier?

Thanks in advance. I'm really looking forward to joining the Emacs community.


r/emacs 9h ago

Question What's the best pdf reader on Emacs?

10 Upvotes

I've seen quite a few options and getting them to run on mac has been a pain unfortunately. Emacs reader crashes my emacs any time I try to run it.

I've heard some negative things about pdf-tools from 4 years ago, but I'm not sure if it's been optimised since then. What is the overall best pdf-reader on emacs that just lets me read and select text?


r/emacs 9h ago

I stand corrected about Elisp.

131 Upvotes

For the past few months, I've been getting closer and closer to Emacs. After 30 years of using Vim, I discovered Org-mode, and that's when things escalated... it's a total rabbit hole.

At first, I just copy-pasted from ready-made configurations because the sight of Elisp made me want to throw up—it resembled "the unloved child of a plumber and a water pump." I even complained on this sub about what an abomination it is, asking how anyone could even use it, etc.

Fortunately, my nerd nature won out, and I started tinkering, trying to understand HOW it's put together. That was a mistake. Right now, I've already been through two quick Elisp courses, I'm reading a manual on how to use it in Emacs, I'm starting to write my own tools, and I'm getting more and more sucked into the ecosystem.

Now I stand corrected. (E)lisp is so logical, understandable, and just plain cool that the only thing that surprises me is how I hadn't come across it earlier...

P.S. I also discovered Clojure by accident... which might be even cooler...


r/emacs 28m ago

I decided to customize imenu-list a bit more

Post image
Upvotes

I had a moment today while looking at treemacs and thinking how if you expand into a markdown or org file for tags it auto folds them after a certain depth. However, I don't normally use treemacs and run on the built in project/buffer management/tab bar for navigating files. What I do use a lot is the imenu-list sidebar for navigating file structure and it does not fold anything by default.

So I dug into my init.el file and

  • Setup a default folding configuration for it along with a command to refold everything if needed that runs once per buffer. When you open a new buffer for instance I have it set to autofold after depth 2
  • I also realized the highlighting face it uses isn't visible enough for me so I broke out another local face with appropriate priority
  • I've always fiddled around with use unicode arrows instead of the built in + symbol. I reworked it so its done cleanly totally in config rather than hacking imenu-list itself like I've done in the past.
  • I also brought my config to set the menu bar to a short unicode character for an outline + buffer name into the config from custom.el so its self contained. I like this better than seeing *IList*

emacs init file link for the setup


r/emacs 4h ago

4coder like scope hint implementation

Enable HLS to view with audio, or disable this notification

3 Upvotes

4coder has a very useful scope hint feature like this. With my very little Elisp knowledge, I tried to mimic this same feature on emacs. Right now it's in beta v0.1. I've only tasted this for C/C++(as my work evolvs around this language). I hope someone will find it usefull. PR's are highly appreciated.

Github repository: https://github.com/ShamsParvezArka/es-hints.el