The world utterly depends on collaboration between humans, AI agents, and traditional computer programs. NeuroScript cuts through the friction in these hybrid systems, bridging the gap between ambiguous natural language and rigid code.
Instead of relying on hidden 'chain-of-thought' or ad-hoc prompts, NeuroScript aims to:
- Provide a shared 'language' – a toolkit of simple, readable, and executable scripts and data formats.
- Capture procedures and information clearly, making complex workflows explicit and repeatable.
- Foster reliable collaboration between all participants (human, AI, or computer).
- Uplift lesser AI models allowing them to do the work of greater ones.
NeuroScript (.ns.txt - Defining a simple action):
:: language: neuroscript
:: lang_version: 0.3.0
:: file_version: 1
func main() means
:: purpose: Main entry point for the script. Walks the current directory and prints file paths.
:: caveats: This version assumes tool.FS.Walk returns a list of maps on success and relies on on_error for tool call failures.
on_error means
emit "An error occurred during script execution."
fail
endon
set allEntries = tool.FS.Walk(".")
must typeof(allEntries) == TYPE_LIST
emit "Files found:"
for each entry in allEntries
if entry["isDir"] == false
emit "- " + entry["pathRelative"]
endif
endfor
emit "Directory scan complete."
endfunc
NeuroData Checklist (.ndcl - Tracking tasks):
:: type: Checklist
:: version: 0.1.0
:: description: Simple project task list.
# Main Goals
- [x] Define Core Problem
- [ ] Design Solution
- [ ] Phase 1: Core language
- [ ] Phase 2: Basic tools
- [ ] Implement & Test
-
Why NeuroScript? Read the motivation and benefits.
-
Core Architecture: Understand the main components (script, data, go).
-
Key Concepts & Features: Explore the underlying principles and features.
-
Language & Data Specs:
- For Senior Tech Staff / Architects: Review the NeuroScript Language Specification, the Formal Grammar Ideas, the NeuroData Overview, and the Agent Facilities Design.
- For All: Browse the specific NeuroData format specifications.
-
Using
neurogo: See the Installation & Setup guide. -
Code & Examples:
-
For Developers: Browse the available Built-in Tools source, look at the examples in the library, and dive into the main Go source code.
-
A more complete example of working code: Update NS syntax
-
-
Project Status & Roadmap: Check the Development Checklist and the high-level Roadmap.
-
Frequently Asked Questions: See the FAQ.
-
Contributing: Read the contribution guidelines.
This project is licensed under the MIT License - see the LICENSE file for details.
Authors: Andrew Price (www.eggstremestructures.com),
Gemini 2.5 Pro (Exp) (gemini.google.com)
:: version: 0.1.6
:: dependsOn: docs/script spec.md, docs/development checklist.md
:: Authors: Andrew Price, Gemini 2.5 Pro (Exp)