AI Agent CLI: Try a Read-Only Task in a Local Project

See what a terminal coding agent does. Inspect two local demo files with read-only permissions, then turn the result into a short tutorial.

What a CLI coding agent sees

Abstract outlined cubes on a warm geometric background

A CLI is the terminal interface

A command-line coding agent takes instructions in a terminal. Depending on its permissions, it can inspect local files, run checks or propose changes. For this demo, keep the job to reading two small files and explaining what it finds.

Flowing line illustration suggesting movement and rhythm

Read the boundaries before starting

Check which folder the session can see, whether writes are possible and how approvals work. In Codex CLI, the documented --sandbox read-only flag selects a read-only command sandbox.

Black starburst illustration on a pale peach background

Make the answer easy to check

Ask for the filename and line where each mismatch appears. Compare those lines with your two inputs and record the reason for the difference in plain language.

Three tasks for a practice folder

Colorful printed posters arranged as a creative mood board

Find a stale menu label

Use a mock README that describes Soup, Salad and Tea, plus a menu.txt listing Soup, Salad and Cocoa. Ask which example differs. You can verify the Tea and Cocoa mismatch by opening both files.

Illustrated scene of two people sitting together

Review an example list for gaps

In a tiny notes project, ask for a comparison between two local lists and a report of the entries that appear only in one. Keep both lists short enough to check on screen.

Scrapbook collage of friends photographed together

Ask for a proposed wording change

Use a text file with one ambiguous label. Ask for proposed wording and an explanation printed in the terminal. Keep the original file in view for a manual comparison.

Record one permission-bounded demo

Creator planning a project on a laptop

Create two demo files

Use a new empty project directory with only the example files. Read them yourself so you know the expected answer, then start the coding agent from that directory with its read-only policy.

Person wearing headphones while working at a laptop

Give a bounded instruction

List the two filenames, the exact comparison and the expected output. If something asks for writes, network access or a wider folder scope, decline the request and narrow the task.

Person holding a tablet displaying illustrated music artwork

Cut a short walkthrough

Record only the sample workspace. Explain the original question, show the agent’s answer and check it manually. Trim pauses in CapCut and give important filenames room to remain legible.

Frequently Asked Questions

What complete prompt or practical brief can I copy?

In this disposable project, read only README.md and menu.txt. Check whether the three example menu labels in README.md occur in menu.txt. Report any mismatch and point to the relevant lines. Leave files untouched, skip other folders and avoid network access.

What does read-only mean here?

It sets a permission boundary for model-generated shell commands. Review which paths your client can read and how its approval and network settings work before sharing a directory.

How is this different from a shell command?

The agent selects actions toward a goal in natural language. A shell command directly invokes an operation you specify. In this exercise, check the agent’s reported finding the same way you would check any colleague’s summary.

Can I do the example without a public repository?

Yes. The two text files can be disposable local fixtures. Include one deliberate mismatch that you already know and verify that the result identifies the right label with the right source.

Where does CapCut come into the process?

Run the example in your chosen terminal client. Use CapCut after you record the local demo to trim dead time, add on-screen context and preview the result at a readable size.

Make the terminal walkthrough easy to follow

Bring your screen recording into CapCut and leave time for viewers to read the instruction and verified answer.