It all starts with the Terminal
AI-powered tools have exposed the practice of software development to people who would otherwise be unable to write code. "Vibe coders" are building apps, automating workflows, and creating tools—all without traditional programming training.
They are also writing scripts, and Terminals love scripts.
You don't need to become a professional developer in order to use some of the tools of the trade. But the more you understand about how these tools like Terminals work, the more powerful these tools become. This includes using AI tools to do the 'writing' of software and scripts.
The gap between "frustrating black box" and "genuine superpower" is smaller than you think.
Why use a Terminal?
AI tools love a Terminal! After using these tools for a bit you may find you love using it too.
Your files, your projects, your tools—they live on your computer. The terminal is how you access them directly. It's the native interface to your machine.
For those who know how to speak its language, Terminals can be very quick, flexible, and powerful. They can do really complex tasks. They can do a lot of small tasks really fast.
It's all about using the right tool for the right job.
Same Model, Different Interface
Every major AI provider offers two ways to access their models: a chat interface in your browser, and command-line tools for your terminal.
Same models. Same APIs. Different capabilities.
Chat interfaces are sandboxed. Text goes in, text comes out. The browser can't see your files, run commands, or touch anything on your system.
CLI tools run on your machine. They can read your files, send relevant context to the API, and act on the response—writing files, running commands, making changes directly.
Same intelligence. Different access.
Same Pattern, Different Words
Now look at the same action - listing files - but without the AI in the middle.
Instead of typing "List the files in this folder," you type ls.
That's it. Same request. Same result. Different syntax.
The Language Barrier
The intimidation comes from the language, not the interaction model.
Terminal commands are terse. They're abbreviations that made sense when keyboards were slow and screens were small:
ls= "list"cd= "change directory"cp= "copy"mv= "move"rm= "remove"
It's a foreign language. But the conversation structure is identical.
Text In, Text Out
Whether you're talking to Claude or talking directly to your computer:
- You type text
- You press enter
- You get text back
The pattern is the same. The only difference is the vocabulary.
And you don't need to learn that vocabulary anymore.
AI Speaks Fluent Terminal
Here's the magic: AI is really good at speaking terminal.
You say what you want in plain English. AI translates it to the precise command. The terminal executes. You get results.
You Don't Need to Learn the Syntax
Want to find all PDF files larger than 1MB? You could learn that the command is:
``
find . -name "*.pdf" -size +1M
``
Or you could just describe what you want and let AI handle the translation.
This is what tools like Claude Code do. They're translation layers between natural language and terminal commands.
Why This Matters
The terminal is incredibly powerful. Decades of tools have been built for it. But the barrier to entry was always the cryptic syntax.
That barrier is gone.
You don't need to memorize commands. You don't need to read man pages. You don't need to Google syntax.
You describe what you want. AI translates. The terminal executes.
The Unlocked Door
Every powerful tool that developers have been using for decades - searching through thousands of files, batch renaming, data processing, automation - is now accessible through natural language.
You describe what you want. AI handles the syntax.
The Original App Stores
The App Store launched in 2008. But app stores have existed since the 1990s.
They just looked different. No icons. No "Buy" buttons. No star ratings. Just text - lists of software you could install with a single command, maintained by communities of developers who shared their work freely.
These are package managers. And they're still the primary way most software gets distributed.
The Landscape
Homebrew (macOS and Linux) - The general-purpose app store for Mac users. Thousands of tools. One command to install anything.
npm (JavaScript ecosystem) - The world's largest software registry. Over two million packages.
pip (Python ecosystem) - The gateway to data science, automation, and machine learning.
Why This Matters for AI
When an AI tool says "install ripgrep" or "you'll need to pip install this," it's pointing you to one of these ecosystems.
- Need to search through thousands of files instantly? There's a package for that.
- Need to convert a video format? There's a package for that.
- Need to process a spreadsheet programmatically? There's a package for that.
The AI isn't asking you to become a developer. It's pointing you to a tool that someone already built, tested, and shared - for free.
The Trust Model
Open source means the code is public. Anyone can inspect it, audit it, improve it. When a package has been downloaded millions of times and maintained for years, you're trusting a community of people who use the same tool.
You don't need to master these. You just need to know they exist.
More Than Just Code
There's an assumption worth naming: terminals are for writing code, code is for programmers, therefore terminals aren't for me.
This assumption is wrong. Completely wrong.
Terminals - and the AI tools that use them - are interfaces to creation. Not just code. Everything a computer can produce.
Documents
Reports. Proposals. Formatted PDFs. Documentation with tables of contents and proper headings. AI tools with file access can take your messy notes, structure them, format them, and output a polished document.
Images
Generated graphics. Processed photographs. Diagrams and flowcharts. Resized, cropped, watermarked, compressed - whatever the task requires.
Visualizations
Charts. Graphs. Dashboards. You have a spreadsheet. You want to see trends. AI tools can read your data, choose appropriate visualizations, and generate them.
Audio
Transcriptions from recordings. Cleaned-up podcast audio. Generated speech from text. AI tools can process sound - transcribe it, manipulate it, convert formats, combine clips.
Scripts That Take Actions
A script that renames 500 files according to a pattern. A script that downloads all images from a webpage. A script that backs up specific folders every night.
This is code, yes. But it's not building an application. It's making your computer do work for you - automating the tedious, repeating the repetitive.
The Reframe
Terminals aren't coding tools. They're creation tools with a text interface.
The question isn't "can I code?" The question is "what do I want to create?"
The tools don't care whether you're a developer. They just execute.
The Unreasonable Usefulness of Markdown
It wasn't immediately obvious that files would become one of the most powerful ways to work with AI. Early on, everything was chat-based - ephemeral conversations that disappeared when you closed the window.
But the community discovered something important:
The output of your work with AI should often be a file on disk.
Why Files Matter
- Persistent context - Unlike chat history that disappears, files stay accessible
- Portable instructions - Move them between tools, share with colleagues, version control with git
- Accumulating knowledge - Build up a library of working patterns and guidelines
Chat is ephemeral. Files are permanent. That permanence changes everything.
Description Becomes Reality
This is the closest thing to magic in practical computing: you describe something in structured text, and it becomes real.
You can describe: - Prompts - Specific task requests you want to reuse - Skills - Teaching the AI HOW to do something - Agents - Shaping WHO the AI is for this context
Why Markdown Specifically?
Markdown hits a sweet spot: - Human-friendly - Reads like normal text - Machine-friendly - AI parses structure reliably - Workflow-friendly - Version control, works everywhere
You didn't install anything. You didn't configure anything. You described what you wanted, and it became real.
Markdown is the lingua franca for AI collaboration.
A Little Bit of Structure Goes a Long Way
Here's what most people send to AI:
I need help with our Q3 report. Sales were up but costs increased too. Marketing did that campaign in August. We should probably mention the new product launch. Oh and the team grew by 3 people...
And here's what they get back: a generic response, followed by ten clarifying questions, followed by something that misses the mark entirely.
Now watch what happens when the same information gets organized:
``` ## Audience CEO, board members
Key Metrics | Metric | Q3 2025 | Q3 2024 | Change | | Revenue | $2.4M | $2.3M | +4.3% | | Costs | $1.95M | $1.8M | +8.3% |
Notable Events - August marketing campaign (+12% leads) - New product launch (September) - Team expansion (+3 engineers) ```
The information was roughly the same. What changed was how it was organized.
Format as Forcing Function
When you choose a format, you choose how to think: - Tables force comparison - Numbered steps force sequence - Checklists force completeness - Headers force hierarchy
The Gift of Empty Cells
The most valuable moment in structuring is when you can't fill something in. Those question marks are valuable - they show exactly what you need to find out.
Structure is a diagnostic tool. It shows you what you don't know.
The clearer your structure, the better your results.
Context Is King
Imagine standing in front of a vending machine. You want chips. You punch in random numbers. Gum falls out. You punch more random numbers. A granola bar. More numbers. Mints.
You're pressing buttons. Just not the right ones.
This is what working with AI looks like without proper context.
Context Has Types
"Give it more context" is advice you'll hear constantly. But the right kind of context matters more than the amount.
Domain Context - What specialized knowledge does this task require?
Your industry terminology, your company's products, your field's conventions. This is knowledge AI needs but doesn't have.
Procedural Context - How should this be done?
Your workflows. Your processes. The steps you follow. The order things happen.
Constraint Context - What are the boundaries?
What NOT to do is often more important than what to do. Length limits. Forbidden topics. Required elements.
Preference Context - How should it feel?
Tone. Voice. Style. Format. Level of formality.
The Anti-Pattern
The instinct is to throw everything at AI - every document, every piece of background - hoping the model will sort it out.
This rarely works. Curated context beats comprehensive context.
Three relevant paragraphs outperform thirty pages of "might be useful."
The vending machine is full of exactly what you want. You just have to press the right buttons.
Decorating Your Prompts
When you talk to someone, you use more than words. Tone of voice. Pauses. Gestures. The way you organize what you say.
Text doesn't have tone of voice. But it has structure. And AI models are remarkably good at reading structure.
Why Decorating Works
AI models were trained on vast amounts of structured text - code, documentation, markup languages, data formats. They've seen millions of examples where structure carries meaning.
When you format your prompts with clear structure, you're speaking a language the model already understands.
Structure reduces ambiguity. When you separate your context from your task from your constraints, the model doesn't have to guess where one ends and another begins.
What You Can Do
- Separate different types of content - Background in one section, request in another, constraints in a third
- Create clear boundaries - XML tags, markdown headers, labeled sections
- Build reusable patterns - Find a structure that works, use it again
The Formats That Work
- Markdown - Headers, lists, bold text. Simplest and most portable.
- XML tags -
,,. Explicit boundaries. - Labeled sections -
CONTEXT:,TASK:,OUTPUT FORMAT:
The format matters less than the consistency. Pick something readable. Use it reliably.
You're not programming. You're signaling.
Decorate your prompts. The model is listening for structure.
The Factory Is the Teacher
Every codebase has a story. Not just in its code, but in its documentation - the READMEs, the comments, the getting-started guides, the troubleshooting pages.
This accumulated writing was always valuable. But it was passive. A record. A reference. Something a human might read when they got stuck.
Now it's something more.
Documentation Works
When you give an AI tool access to documentation - a getting-started guide, an API reference, a project README - something interesting happens. The AI doesn't just read the documentation. It uses it.
The patterns in the code examples become patterns it can follow. The troubleshooting steps become diagnostic procedures it can apply.
Documentation has become productive. It does work.
The Accumulated Walls
Think about what exists in any mature project: - Onboarding guides that encode how things should be done - Style guides that encode preferences and standards - Decision logs that encode institutional reasoning - FAQs that encode common problems and solutions
This is the "factory walls" - the accumulated wisdom built up over time, written down, maintained, refined.
For decades, this knowledge sat in documents that humans had to find, read, and internalize. Now AI can read them, internalize them, and act on them in seconds.
The Gap Has Narrowed
You now understand: interfaces shape what's possible. Terminals are conversations. Package managers are app stores. Computers create more than code. Markdown files are executable specifications. Structure clarifies thinking. Context has types. Decoration signals meaning.
And documentation - yours, theirs, everyone's - now does work.
Press the right buttons. Build something.
#!/bin/bash for f in *.jpg; do d=$(exiftool -d "%Y-%m-%d" -DateTimeOriginal -s3 "$f") mv "$f" "$d_$f" done
I'd be happy to help! To write an effective email, I'll need some details:
• What caused the delay?
• How long is the delay?
• Who is the audience?
Based on ~/projects/atlas/status.md:
Here's a draft email for the Atlas project delay:
"Hi team, the vendor integration is taking longer than expected. We're now targeting March 15th instead of March 1st. I've updated the timeline doc with details."
✓ Saved to ~/Desktop/delay-email.txt
find . -name "*.pdf" -size +1M npm install prettier pip install pandas ## How to respond...
## Task: Analyze CSV data - Read sales.csv - Generate monthly trends - Output chart as PNG <context>Building a sales dashboard</context> <task>Create a summary</task> <constraints>Short, professional</constraints> ## Context Building a sales dashboard ## Task Create a summary CONTEXT: Building a sales dashboard TASK: Create a summary CONSTRAINTS: Short, professional