8 ms·
Show HN: I wrote a modern Command Line Handbook
TLDR: I wrote a handbook for the Linux command line. 120 pages in PDF. Updated for 2025. Pay what you want.
A few years back I wrote an ebook about the Linux command line. Instead of focusing on a specific shell, paraphrasing manual pages, or providing long repetitive explanations, the idea was to create a modern guide that would help readers to understand the command line in the practical sense, cover the most common things people use the command line for, and do so without wasting the readers' time.
The book contains material on terminals, shells (compatible with both Bash and Zsh), configuration, command line programs for typical use cases, shell scripting, and many tips and tricks to make working on the command line more convenient. I still consider it "an introduction" and it is not necessarily a book for the HN crowd that lives in the terminal, but I believe that the book will easily cover 80 % of the things most people want or need to do in the terminal.
I made a couple of updates to the book over the years and just finished a significant one for 2025. The book is not perfect. I still see a lot of room for improvement, but I think it is good enough and I truly want to share it with everyone. Hence, pay what you want.
EXAMPLE PAGES: https://drive.google.com/file/d/1PkUcLv83Ib6nKYF88n3OBqeeVffAs3Sp/view?usp=sharing https://drive.google.com/file/d/1PkUcLv83Ib6nKYF88n3OBqeeVff...
https://commandline.stribny.name/ https://commandline.stribny.name/
- charlie-83 1y agoCool, couple of comments. The website it a bit broken on mobile (at least for me) since text goes off the screen. Second, it would be good to have some sample pages or at least a page of contents so people can see the level of detail the book is aimed at. I know I could just get the book for free and then pay later but that kind of a faff and I feel bad choosing $0 for these kinds of things.
- petr25102018 1y agoThanks for the feedback. I was trying to make it work on mobile but maybe I didn't test it well in the end. As for a sample, I will go and try to make something now. Thanks. Edit: Example pages here: https://drive.google.com/file/d/1PkUcLv83Ib6nKYF88n3OBqeeVffAs3Sp/view?usp=sharing https://drive.google.com/file/d/1PkUcLv83Ib6nKYF88n3OBqeeVff...
- PeterWhittaker 1y agoOne nit: ^D only exits if the cursor is at the beginning of a line. Enter <space>^D and the session remains. Otherwise, looks good! Use of "env" and proper quoting are strong signals!
- petr25102018 1y agoThanks for the clarification. I will see if I can sneak in a note about this in the next update :)
- danadam 1y agopage 112 > if [[ "${1-}" =~ ^-*h(elp)?$ ]]; then > ... is an option that starts with one or multiple - characters ... "one or multiple" is + not *. The regex above will also match "h" and "help" without - character(s).
- pipes 1y agoI agree with all this. I'm on Firefox android, pixel, lose part of the screen too. I'd love to read a table of contents. I don't want to rip you off with zero dollars! Anyway, sounds like a great book. Congratulations on completing and "shipping"!
- petr25102018 1y ago> I agree with all this. I'm on Firefox android, pixel, lose part of the screen too. Ah okay, I really wasn't aware. Thanks for reporting.
- jaredhallen 1y agoI am also seeing text off the screen using Brave on Android.
- petr25102018 1y agoYou are right. It is wrong, will need to look into this.
- curtgrimes 1y agoThese two tweaks should improve it (by preventing the largest text and book graphic from overflowing the viewport horizontally on some smaller screen sizes): diff --git a/index.html b/index.html index a0f978c..040e50e 100644 --- a/index.html +++ b/index.html @@ -21,3 +21,3 @@ h1 { - font-size: 3.8em; + font-size: clamp(2.2em, 7vw, 3.8em); margin-bottom: 0; @@ -60,2 +60,3 @@ .hero-img { + max-width: 100%; transform: rotate(2deg); Also, I really like what I see in your book so far and I am already learning things on the first few pages. Thanks!
- petr25102018 1y agoOh that's great. Thanks!
- JLO64 1y agoHonestly I would’ve liked to fork over cash for a book like this but the deal breaker for me is that it’s in PDF format. I like to read all of my books on a Kindle (with koreader installed) so epub files that can be resized to fit its weird dimensions are a must.
- petr25102018 1y agoNoted. I will try to provide alternative formats. Not sure how it will go with the code examples, but I shall try. Edit: One reason why I picked PDF is that I expect the readers to actually follow the examples in their own terminal while going through the book. So in that sense I was thinking about reading it on the desktop.
- InsideOutSanta 1y agoYeah, same. On a phone or smaller e-reader, regular PDFs designed for normal book size are often unreadable.
- username223 1y agoThat's a big ask. I've written a couple of books, and PDF/print vs. ePub/webpage is a decision I had to make up front. For anything with more than the most basic formatting (e.g. a novel), the design and layout are different enough that one of them will turn out looking like crap. Given the audience, I probably would have chosen ePub for this one, but the book's done now. Also, a TOC and sample chapter would be great. A lot more people will be likely to pay if they know what they're getting.
- petr25102018 1y agoHonestly I haven't tried yet. Maybe Asciidoctor (Which I used) has it figured out. It would at least need to have good enough output for the code examples, otherwise it would probably be a non-starter. I added links to example pages (which include TOC) to the Gumroad page and here, but yeah I should have put it on the homepage.
- rmahan 1y agoHave you tried pdf reflow with koreader? I find it works pretty well
- petr25102018 1y agoExample pages here: https://drive.google.com/file/d/1PkUcLv83Ib6nKYF88n3OBqeeVffAs3Sp/view?usp=sharing https://drive.google.com/file/d/1PkUcLv83Ib6nKYF88n3OBqeeVff...
- justusthane 1y agoI consider myself reasonably proficient in the shell, but I learned something just from your sample pages (process substitution). Purchased!
- petr25102018 1y agoThanks!
- teddyh 1y agoIf you have not skimmed through the manual of bash¹ enough to learn about process substitutions, what makes you think you would read a book? 1. <https://www.gnu.org/software/bash/manual/bash.html https://www.gnu.org/software/bash/manual/bash.html>
- cortesoft 1y agoMaybe because they didn't think to?
- mtlynch 1y agoDifferent people prefer different formats for information. Some people prefer to read the manual from start to finish while others learn better seeing the same concepts in a hands-on tutorial. From reading the sample of OP's book, it seems far more practical and accessible than the bash manual, so I'm not surprised that a lot of people would read OP's book that have no interest in reading the bash manual cover to cover.
- justusthane 1y agoBecause generally a manual is “here is every single detail of this thing”, while a book like this is “here’s an overview of the particularly useful stuff.” I’ll go to the manual if I’m trying to understand how a particular thing works, or how to do a particular thing, but it’s not as useful to me for feature discovery.
- mtlynch 1y agoCool book! Humble suggestion: Give more specific examples of what the reader will learn on the landing page. From the landing page, I don't know if this is for total command line beginners or has helpful tips for people familiar with bash already. I had to hunt around to find sample pages, and they provided much better sense of what's in the book. Also, spotted some small issues in the copy: "Fresh out of press" - The more common expression is "hot off the press." "Out of press" sounds similar to "out of print" (i.e., no longer sold) "Grok the Linux command line on only 120 pages" - should be "in only 120 pages"
- petr25102018 1y agoTrue, the landing page could be more detailed. I didn't want to repeat much the info on Gumroad page, but maybe I should rethink it. And thanks for the copy suggestions. I am not a native speaker :)
- frosting1337 1y agoI definitely think you should add more info to the landing page - I had no idea there was further information on the Gumroad page.
- rubit_xxx17 1y agoI’m excited about this book and appreciate your work! One thing that was distracting was the large title font when I tried to view this site in portrait mode on mobile, as some of the letters are cut off. If that could be fixed, it would help ensure people stay engaged and read it. You could also potentially use an LLM or something like Grammarly to help proofread it (not edit it). This is very cool!
- petr25102018 1y agoThank you! Yes, as other people pointed out too, the landing page could do with some mobile and copy improvements.
- 1y ago
- dedicate 1y agoIt makes me wonder – what's that one command or concept you CLI vets wish you'd learned way earlier that totally changed your game, something that might be in that 'next 20%'? Curious about those 'aha!' moments!
- justusthane 1y agoGet really comfortable with find and grep. They’re incredibly powerful. perl -pe is way easier than awk.
- jcynix 1y agoI'll second that. And would like to add that find plus xargs is important to know, as it often works much better than the clumsy "exec in find itself. Oh, and thus of course find ... | xargs perl -lne "fancy stuff" to do some fancy stuff with found files ;-)
- geocar 1y agoI really think you should use: find ... -exec perl -lne "fancy stuff" {} + because for one it doesn't mess with stdin, and for another you don't have to worry about filenames with spaces or newlines in them. I also like -execdir since if my script dumps any output to other files I'll probably want that output near the sources. And did I mention it does nothing if there are no matching files? I also think it looks better and is shorter. If you really can't remember that or want to continue to pollute the environment with extra heat generated by running two cpus to do the job one can do, you should at least use -print0/xargs -0 because of spaces, and always use -r to more sensibly handle an empty result-set from find et al (gnu xargs runs once!)
- petr25102018 1y agoOne of my favorites from the book is to alias "xdg-open" to "open" because I never remember the command. So now I can just type "open X" to open a file system location or file in a normal GUI program when needed. It is a small thing but I use it a lot. Something that I didn't put in the book because I learned it only recently is the use of "notify-send", aka you can send yourself a system notification from the command line or script (at least it workd for me in Gnome). For instance once a task is finished: > echo "when finished send notification" && notify-send "system notification" Pretty cool if you ask me!
- catoc 1y agoInterested, but going to the website told me nothing other than a book about the command line. Would be nice be able to get a preview of a some pages/chapters.
- petr25102018 1y agoNoted. For now I put links here, in the comments, and in the Gumroad page to sample pages. I will need to change the homepage later. Thanks for the input!
- nickjj 1y agoHow has the "pay what you want" model worked out if you don't mind me asking? It's something I've thought about in the past for selling courses.
- petr25102018 1y agoI just changed the payment model before posting it here, so there is no past data on this. I don't expect it to generate revenue compared to normal sales (it will most likely be a small fraction). But for normal sales you need to be able to promote it. My primary motivation is to share the work that I spent a lot of time on because I want to move on and work on other things (I don't want it to just sit on my disk when it can be useful to others before getting outdated etc.). It never was meant to be some primary source of income. In that case I would be writing a book about AI :) Maybe I will write a blog post with some reflections about making the book at some point :)
- ctippett 1y agoI admire your mindset (and humility). Thanks for making this available.
- bprater 1y agoAny alternatives to Gumroad in buying this?
- petr25102018 1y agoNot for now. But I am happy to send you the PDF by email and receive a donation via PayPal if the reason is not to fund Gumroad. Just contact me on petr@stribny.name or @stribny on X.
- meonkeys 1y agoWhy?
- sillyboi 1y agoSorry, but it would be great to adapt it for the mobile layout.
- petr25102018 1y agoDo you mean the website or are you talking about the book PDF?
- sillyboi 1y agoI meant the website.
- KasianFranks 1y agoAhh yes, the lost art of UNiX sys admin always comes back.
- MikeTheGreat 1y agoThis is excellent! Thank you for posting and best wishes for your success with this! I'm teaching a class next year that'll have college-level students learning to use the command line and this looks perfect. Nowadays most 'learn the shell' resources online seem to focus on how to write scripts, without explaining how to use it interactively. Given this will be (for many) their first experience with a command line stuff like "type your command, then press enter", or "Up arrow to go back through your history" are a necessary foundation for them. Not to mention stuff like Job Control and using AI to help you create the more complicated commands that folks need to do - nicely done! Plus, the book is inexpensive enough that they can still afford other resources too :) Definitely gonna recommend this next year :)
- petr25102018 1y agoThank you for the nice words :)
- dkarl 1y agoIs your focus on older tools that tend to be on most machines and used in older shell scripts (e.g., find and grep), or on newer and upgraded tools (fd, fzf, rg) that developers install on their own machines, or both?
- petr25102018 1y agoThe older standard tools, because they can be easily put in CI pipelines and shared as scripts with coworkers. For example, in my personal and professional life I use Make everywhere. The book mentions alternatives, but the examples are built on the time-tested tools. I focused on things that don't require install (if given the option) or the ones that you are more likely to encounter at work. It is a tradeoff and I can see how the reverse would be appealing too.
- cerved 1y ago<3 GNU Make
- ontouchstart 1y agoMake is a powerful self-documentable tool. It can hide tons of complicated dependencies implementation details behind a simple and universal CLI.
- subjectsigma 1y agoIf you want to use make, power to you, it’s definitely a useful tool. (What I’m trying to say is I’m bashing make, not you.) That being said, I absolutely hate make, there are so many footguns and weird quirks and implicit behavior that always end up biting me. I find that 90% of the time what I actually want is a command runner like Just (https://github.com/casey/just https://github.com/casey/just) and have the make file contain the absolute sheer minimum required to build code. While we’re at it, CMake is another build tool with the same problems as make - powerful, with an ugly syntax, unintuitive semantics, hidden dragons, and a manual that’s torturous to read.
- JulianWasTaken 1y agoLooks very nice! I have an interactive tutorial I wrote and teach with which is here: https://github.com/JulianEducation/CommandLineBasics https://github.com/JulianEducation/CommandLineBasics in case it's useful as well. I only have 90 minutes in my case so it's a constant battle to tweak what I can get to with my audience, so there's still lots of things I want to change. But I think it's very important to have lots of resources here so I'm excited to look at yours.
- petr25102018 1y agoThanks. You teach this in a classroom?
- JulianWasTaken 1y agoI do, it's given as a seminar twice a year.
- petr25102018 1y agoNice! At least you get your feedback in real time, see what people struggle with and so on. That can be very useful.
- rochak 1y agoGood resource to couple this resource with: https://linuxjourney.com https://linuxjourney.com.
- asicsp 1y agoSee also this open source version inspired by that site: https://github.com/daquino94/linux-path https://github.com/daquino94/linux-path
- 123sereusername 1y ago[dead]
- _joel 1y agoNice work, I've been using linux 20+ years and learnt something from the example pages. (edit, just realised it's closer to 30 now, jesus)
- petr25102018 1y agoThanks!
- deleted 1y ago[deleted]
- briandoll 1y agoFolks interested in this will also appreciate The Shell Haters Handbook: https://shellhaters.org/deck/ https://shellhaters.org/deck/
- MaggieL 1y agoAlso don't miss https://wizardzines.com/ https://wizardzines.com/
- honkycat 1y ago#1 thing in command line shell scripting should be: "Do not use it for advanced scripts. If you have multiple if statements and for loops, rewrite it in a higher level language." This is also the advice given in the google shell guide. I say this after years of being a DevOps and Platform engineer. Bash is trash. It is great for 10-20 line scripts. Beyond that, it is worthless.
- petr25102018 1y agoI would not say it is trash, but I tend to agree with the general sentiment and personally don't write longer scripts. > This is also the advice given in the google shell guide. This advice is also given in this handbook :) But in reality you might come to a work repo that already has such scripts and it is good to understand it a little bit, I would think.
- honkycat 1y ago"I might come to work on..." Friend, you have no idea LOL My hatred is well earned!
- brontosaurusrex 1y agoIs there an explanation why? (Average line count in my scripts is 115).
- honkycat 1y agoCryptic, overly complicated syntax. for loops, if statements, etc.. are all done better in other languages. No package manager, build, or dependency features. This means it is ugly and gross to import functions from other programming languages. Zero data structure support, so any data manipulation is horrible. No test support, so you can't mock and test business logic. No debugger support. It's just a bad, cryptic, confusing language that is hard to maintain. Remember: it's not that you CAN'T do these things, it's that they work better in other languages, like Node or Python. And shelling out in Python or node works great and is very easy. And Python comes built into most systems these days. It is hard to justify writing shell scrips anymore. It's like writing perl or cobol. We have better tools now, the world has moved on.
- shivajikobardan 1y ago[flagged]
- 0x62 1y agoThe content seems really great, however the typesetting makes it quite hard to read: * Code blocks on a subsequent page to the explanation, especially when there is enough space to show it (p18/19) * Call-outs as above (p26/27) * Single words broken by a page (p51/52) * Footers spanning multiple pages (p61/62) It sounds quite nitpickey but I find it really breaks the flow when I’m reading, and trying to comprehend a section requires scrolling back and forth between two pages.
- petr25102018 1y agoThanks for the feedback. I agree and I try to keep it as nice as I can, but it can be hard to do when the book is being updated and the content changes. Nevertheless I will be mindful of it for the next update.
- sagarpatil 1y agoJust bought it. Any advice on how to use the book to master the terminal? One page a day or try to finish everything in a week or two?
- petr25102018 1y agoI definitely recommend to try things as you go along, copy paste things and run them yourself. As for the timeline, everyone is different. My own take is that learning always takes time and repetition, so I would not rush it and focus on practice.
- asicsp 1y agoI wrote interactive TUI apps with exercises for Linux CLI tools, coreutils, grep, sed and awk: https://github.com/learnbyexample/TUI-apps https://github.com/learnbyexample/TUI-apps
- jdshaffer 1y agoLooks nice! Purchased a copy. :-)
- petr25102018 1y agoThank you
- mettamage 1y agoIf one reads a book like this and becomes good at the command line. How much do they still need to grok/pickup from devops to be competent at it?
- petr25102018 1y agoDevOps is not very specific term... so hard to list specific things to learn. But it certainly will be much, much more than just shell/command line knowledge.
- swhite237 1y agoAny resources or suggestions for how to find projects or exercises for each section? I need to train some people (who will never use the command line and will go back to excel and VSCode, but I am not the genius who decides what people have to be competent in…) and this book is great, but I don’t think they are motivated enough to learn without some projects or problems and I struggle to invent nonsense projects.
- tanchaowen84 1y agocool! Even though it’s getting easier to use AI to generate commands these days—I often ask AI to help me write commands myself—I still think it’s important to understand and systematically learn the command line. I’ll definitely recommend this book to my friends. One suggestion: maybe you could include some practical examples from real work scenarios in the book to make it even more approachable and engaging.
- petr25102018 1y agoI don't want to just add to it because the entire idea is to have a short book, but I will be thinking about replacing/improving some sections. The examples already demonstrate the practical scenarios, but I think there could be a few sentences about how a particular concept can be used in real world scenario. Thanks for sharing:)
- gknoy 1y agoWow. This is amazing. I really like the way you use color and do footnote-like explanations.
- petr25102018 1y agoThank you!
- javaliendo 1y ago[dead]
- deleted 1y ago[deleted]