Contexta

A command-line AI assistant that provides contextual awareness by accessing your local filesystem and web content. Built using Kotlin, LangChain4j, and MCP.

Features

• Terminal-based AI chat CLI with markdown support
• MCP
• Persistent chat memory

Configuration

Create a config file at ~/.contexta/config.properties with the following:

baseUrl=<openai compatible url>
apiKey=<your api key>
modelName=<model name>

Building

The project uses Amper build system. To build:

./amper build

Usage

Run the application:

./amper run

Or directly with the generated JAR:

./amper package && java -jar build/tasks/_cli_executableJarJvm/cli-jvm-executable.jar

Commands

• Type your query and press Enter to send it to the AI
• Type /exit to quit the application

Project Structure

• cli: Command-line interface implementation with terminal UI
• integration: Core logic for model interaction, tool integration, and configuration

License

MIT