docs: make second-brain example runnable with local runtime#117
Closed
dottie-weaver wants to merge 2 commits into
Closed
docs: make second-brain example runnable with local runtime#117dottie-weaver wants to merge 2 commits into
dottie-weaver wants to merge 2 commits into
Conversation
…overy - runtime run <target> creates a workflow run and returns available nodes - runtime run (no target) lists available workflows - CLI resolves --base-dir to absolute path for consistent path handling - workflow filesystem adapter falls back from versioned to unversioned graph names - Adds runtime config to root .agentic/config.toml for dogfood - Includes workspace package setup for examples/* and test coverage Tested end-to-end in dogfood session (closes #111).
) - Add seed task and artifact for out-of-box experience - Update README with Running Locally section covering runtime setup, workflow run commands, and Agentic-vs-runtime ownership boundaries - Update AGENTS.md with runtime run and workflow transition commands - Clarify what is not yet implemented (daemon, Cloudflare, sessions) - Note .agentic/runtime/local/ in What Is In Here table Acceptance criteria met: ✅ Example README includes a runnable local-runtime path ✅ Docs distinguish Agentic core from the local runtime clearly ✅ Docs connect back to #100 without duplicating its roadmap ✅ A future user can answer 'how do I actually run this thing?' from the example docs alone
Collaborator
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Closes #112
What
Updates the second-brain example so a new user can understand and run it through the local runtime — without Cloudflare, daemon mode, or external services.
Changes
Example docs (README.md)
runtime run, and workflow transition commands.agentic/runtime/local/Harness docs (AGENTS.md)
runtime run,workflow start/done/nextcommandsruntime runandworkflow start/done/nextto the Agentic usage listSeed data
.agentic/tasks/01KTC500000000000000000001.json— seed research task.agentic/artifacts/01KTC500000000000000000010/— seed research brief (finalized)Code changes (prior dogfood session, now committed)
runtime run <target>creates a workflow run and returns available next nodesruntime run(no target) lists available workflows--base-dirto absolute path for consistent path handlingpackage.jsonincludesexamples/*in workspaces.agentic/config.tomladds runtime config for local dogfoodAcceptance criteria
Testing
runtime run research-loopcreates a run, returns node info, and workflow transitions work