AGENT IN THE SHELL
A PERSONAL PROJECT BY CHIA
VISUAL DESIGN
JOSHUASPRINGSRINNK1Y

AN AGENT. A SHELL. A LOOP.

AGENT MODIFIES
THE WORLD
AND
ITSELF

Born from my research workflow: the agent organizes intent, writes the code, and verifies the work.
As the experiments continued, the agent needed a persistent working environment.
So the core entered a shell—a home for knowledge, delivery topology, and workflows.
The boundary between shell and world begins to blur: through the shell, the core modifies the world; by modifying the shell, it modifies itself.

Agent in the Shell, visual core
CoreTHE AGENT

Understands intent, calls tools, runs experiments, and modifies code.

ShellTHE SHELL

Loop harness and visualization, so the core's behavior is structured and observable.

ENTRY / THE SHELL

One need leads to another. Capabilities keep expanding.

ORIGIN / FROM THE LAB

Experiment operator. Self-evolving agent. What next?

Structured experiment management

During my research, I noticed that the agent documented experiment procedures in specs, plans, and configuration files, and archived the results alongside them. Each experiment now had a structure I could inspect and run again.

Deploying a research assistant

The work spanned a local machine and a server, alongside research and knowledge repositories. I gave those operations to a dedicated agent: create the run, collect the result.

The first shell

As experiments accumulated, I built a frontend to view configurations, results, and logs, and paired it with the agent. This created a distinction between shell and core: I interact with the core through the shell, using it to define gates and shape behavior.

Can it modify its own shell?

Then the shell became a task for the core. The core modifies the shell in a sandbox and launches a separate agent to verify the changes. The changes are merged only after external review. With a sense of touch—the ability to sense user interactions—the core began interpreting those actions and forming intentions to modify the shell.

LOOPS / MULTIPLE LOOPS

Run the work. Rewrite the body. Verify the capability.

Run the work

Turn user intent into an experiment plan, execute, collect the result

IntentConfigureExecuteCollect
IntentPlanCodeArchive
With new evidence, pose the next question

Rewrite the body

Understand user needs through interaction signals and conversation, modify the shell in a sandbox, then submit the changes for external approval and merging.

ProposeModifyValidateMergeRelease
With a new organ, find the next improvement

Verify capability

Evaluate cost, safety, and effectiveness. Capture reusable test cases, run them, and review their results with one-click actions.

HistorySnapshotGenerate
LoadRunReviewArchive
With a new capability, explore the next target

AGENT FACTORY / WHERE THIS GOES

Take this way of working to the next project.

Swap in another project's knowledge, a set of task SOPs, and verification rules. The core works in a new context, keeping the structure of observation, tests, review, and delivery.

Per projectKnowledge & goals · Task SOPs · Verification rules
Structure we keepCore & shell · Sandbox isolation · Review & delivery
Where this goesA portable agent and a CI/CD workbench