Metacognitive Tooling Scaffolding for AI Agents

The @cogtools/cogtools utility provides a declarative way to provide metacognitive tools for AI agents.

Metacognitive tools provide pre-made thought-forms for an AI, guiding and shaping is cognition.

Initial scope is Gemini in the Gemini CLI environment.

The same approach should work in other environments, supporting .gemini directories, for example, in the Gemini Code Assist.

Project Status

This project is in active development. Use at your own risk.

See Concept meanwhile.

Background

Gemini CLI's LLM toolset is configurable in .gemini/settings.json.

Users may provide tools either by configuring MCP servers, or directly, via command-line integration.

Users also may set up semi-rudimentary Gemini CLI Extensions in .gemini/ directories.

Installation

Note

The examples below use pnpm as a package manager.

TODO: Provide instructions for other package managers.

pnpm install -g @cogtools/cogtools

TODO: Document pnpx use (provided it is meaningful).

Configuration

TODO: Document

Advanced Usage

TODO: Describe coding a tool in-place (as a shell-executable), as well as loading it as a module.

Development

TODO: Document

License

MIT. See LICENSE for more information.