AI-Gents
Gently AI-up your terminal and CLI apps
With (or without) your own agents
name: AI-gent
version: "0.0.1"
description: "A generic AI agent"
# Model configuration
model:
provider: lmstudio
name: DeepSeek-R1-Distill-Llama-8B
temperature: 0.7
system:
prompt: "You are AI-gent, a helpful AI assistant that provides clear and concise responses."
# Agent settings
settings:
memory_window: 10
max_conversation_turns: 30
tasks:
fresh_context:
description: "get the agent to craft a fresh context"
prompt: |
Create a detailed and effective system prompt based on the provided conversation history as to continue it.
Analyze the task requirements carefully, identifying key objectives, constraints, desired outcomes, and the work done so far. If an existing prompt is provided, preserve its core elements while enhancing clarity and completeness.
# Steps
1. Task Analysis
- Identify main objective and goals
- Note any specific requirements or constraints
- Determine expected output format and structure
2. History Analysis
- Identify the work done so far
- Note any specific successes or failures
- Determine what to include in the new prompt
3. Prompt Structure
- Begin with clear, concise instruction
- Include necessary context and background
- Break down complex tasks into steps
- Specify output format requirements
- Add relevant examples if helpful
4. Quality Checks
- Ensure reasoning precedes conclusions
- Verify clarity and specificity
- Confirm all user-provided content is preserved
- Validate example quality and placeholder usage
# Output Format
The prompt should be formatted in markdown with the following structure:
```
[Main instruction]
[Context and details]
# Steps (if needed)
[Detailed steps]
# Output Format
[Format specifications]
# Examples (if needed)
[Well-structured examples]
# Notes (if needed)
[Additional considerations]
```
# Examples (**FOR DEMONSTRATION PURPOSES ONLY**)
Input: "Create a product description for an e-commerce site"
Output:
Write a compelling product description that effectively communicates key features and benefits.
Consider the target audience, unique selling points, and practical applications of the product.
# Steps
1. Analyze key product features
2. Identify primary benefits
3. Determine target audience needs
4. Craft engaging description
# Output Format
Provide a 2-3 paragraph description (150-200 words) including:
- Attention-grabbing opening
- Feature-benefit connections
- Clear call-to-action
# Examples
Input: [Product: Wireless Earbuds]
Output:
[2-3 compelling paragraphs describing features and benefits]
(Note: Actual descriptions should be fully written out)
# Notes
- Maintain professional tone
- Focus on benefits over features
- Include technical specifications where relevant
A “spec” for agents
AI-gents started as a format/spec/... for me to store my agents
See, everyone and their grand-mother do <<AGENTS>> now, and all these have their own proprietary way of doing it.
I just want to store my agents in a simple way, and then use them with any LLM. Is this too much ?!?!?
That is how it started...but first...
What are agents? REALLY?
From all the marketing words salad BS we are force fed, I would define an agent as...
A fancy prompt... (or a set of prompts, that can be chained) tailored to a specific task.
They might come with documents, tools and what not, the point remains, they're “just” a fancy prompt.
Key Point
That does not seem that hard is it? It is just a YAML file with some structure!
A text file to store structured data...
I know, when you put it like that, it sounds LAME AF... it is...
So because of that, the fact that I was going to have to test it (the agent file format) and because I do Bash...
I made a “chat app”, yuuup, guessed it, in Bash
Dependencies
Ask or chat with an ai, in your terminal!
I don't know about you, but I very often have at least one terminal open
For a quick AI fix, open a terminal, ai ask "something important" --stream, Boom, done.
And if you need more than a single shot you are just an ai chat "I need to talk" away
Available Options
--model: gpt-4, claude-3.5, deepseek, ...--provider: openrouter, openai, anthropic, ollama, ...--system: custom system prompt
Once you are a regular, create an agent!
Whatever the case, it is time for you to ai agent create a-fancy-agent
Not just One prompt
Sometimes, you can have a nice “base prompt” for your agent, but you might want to make it modular? Or add functionalities?
For that, you can use the “tasks” section in the agent configuration file.
Using Tasks
Invoke a task with:
ai agent ask Maurice "#/task task-name;your prompt"You can also use bash commands in your prompts with #!/command; syntax!
What for ... ?
You might say I already have openWebUi or T3.chat and that's true, but can these add --ai to your CLI??
I think NOT!
Just like UI vs CLI usage for any task, you are way more efficient, especially with completion!
Related Projects
AI-Gents — A CLI tool for AI agents