Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 

README.md

Claude Code

the CLI is where the real power lives.

IDEs are valuable for visual navigation and GTM workflows. but when you need to spawn parallel agents, automate pipelines via cron, or chain generation steps through subprocess calls... you need the terminal.

Claude Code with a Max subscription means no API keys, no token billing, no usage caps to worry about. just claude -p and go.


Why CLI-First

the IDE extensions give you autocomplete, inline diffs, and visual context. that matters. but the terminal gives you something the IDE can't: composability.

a CLI command can be piped, scripted, cron-scheduled, and subprocess-spawned. you can run three terminals in parallel, each with its own Claude Code session, each working on a different part of the same repo. you can build a Python script that calls claude -p as a subprocess and processes the output programmatically. you can schedule a cron job that runs a generation pipeline at 6am every morning.

none of that works through an IDE chat panel.

the CLI is a building block. the IDE is a workspace. you want both, but the engine is the CLI.


The Max Advantage

most AI coding setups require:

  • an API key
  • a billing account
  • careful token management to avoid surprise costs
  • rate limit handling

Claude Code on Max requires none of that. your subscription covers everything. claude -p calls cost you nothing beyond the subscription you're already paying for. this changes the economics of what's worth automating.

when a generation call is free at the margin, you can:

  • run speculative passes (generate three drafts, pick the best)
  • build pipelines that make dozens of calls per run
  • automate daily content generation
  • throw compute at problems without counting tokens

the constraint shifts from "is this call worth the cost" to "is this call worth the time."


What You Can Do

non-interactive generation with claude -p

the backbone of every automated pipeline. pass a prompt, get text back. no interactive session, no human in the loop.

echo "write a function that parses CSV files" | claude -p --output-format text

see cli-patterns.md for the full pattern library.

multi-terminal parallel agents

run 3+ Claude Code sessions simultaneously. front-end agent in one terminal, back-end in another, reviewer in a third. all sharing the same repo, coordinating through git.

see multi-terminal.md for setup and workflow patterns.

subprocess spawning from scripts

call Claude Code from Python, bash, or any language that can spawn a subprocess. build generation into your existing toolchain.

result = subprocess.run(
    ["claude", "-p", "--output-format", "text"],
    input=prompt,
    capture_output=True,
    text=True,
    timeout=180,
)

cron automation

schedule generation pipelines to run on a timer. daily blog drafts, weekly report summaries, nightly code reviews.

0 6 * * * cd /path/to/project && ./scripts/generate.sh >> /tmp/generate.log 2>&1

IDEs Are Complementary

this isn't anti-IDE. Cursor, Windsurf, and other AI-assisted editors are genuinely useful for:

  • visual code navigation: jumping between files, seeing project structure at a glance
  • inline diffs: reviewing AI-generated changes in context
  • autocomplete: the bread and butter of daily coding
  • GTM workflows: when you need to see and edit simultaneously

the split is straightforward:

use case tool
exploring a codebase visually IDE
writing code with autocomplete IDE
running a generation pipeline CLI
parallel agents on the same repo CLI
automated/scheduled generation CLI
subprocess integration CLI
interactive pair programming either

use the IDE as your workspace. use the CLI as your engine. they're complementary, not competing.