Skip to content

ProfRandom92/comptext-dsl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

22 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CompText DSL

Token-efficient Domain-Specific Language for LLM interactions

MCP Compatible Codex Skills License: MIT

What is CompText DSL?

CompText DSL is a specialized language designed for efficient communication with Large Language Models. Instead of sending massive context repeatedly, you define structured, reusable commands that integrate seamlessly with modern AI tooling.

Key Benefits

  • 90-95% token reduction - Dramatically reduce API costs
  • MCP Compatible - Full Model Context Protocol support (November 2025 spec)
  • Codex Skills - Native OpenAI Codex CLI integration
  • Standardized patterns - Consistent, reusable commands
  • Version controlled - Track changes to your AI interactions
  • Team collaboration - Share commands across your organization

Quick Examples

Traditional vs CompText

Instead of:

"Here's my entire coding style guide... [25,000 tokens]"

Use:

use:code-style-v2

Codex Skills (v1.1)

# Invoke Codex skills directly
$code-review
$draft-commit-message(style="conventional")
$analyze-tests

MCP Tools (v1.1)

# Define MCP-compatible tools
tool fetch-data {
  name: "fetch-data"
  description: "Fetches data from external sources"
  inputSchema: {
    type: "object",
    properties: {
      source: { type: "string" },
      limit: { type: "number" }
    }
  }
}

# Use MCP resources
@database/users/schema
@config/settings

Async Tasks (v1.1)

# Define long-running operations
task data-processing {
  name: "data-processing"
  timeout: 300000
  handler: "process_data"
}

Integration

CompText DSL works with:

Platform Protocol Status
Claude MCP Full Support
Codex CLI Skills Full Support
ChatGPT Skills/MCP Full Support
Claude Code MCP Full Support

Related Projects

Getting Started

# Coming soon: parser installation
pip install comptext-dsl

Basic Usage

# Import modules
import "data-processing" as dp

# Define variables
api_url := "https://api.example.com"

# Use commands
dp.fetch(source=$api_url)
dp.transform(type="json")

# Invoke skills
$validate-output

Documentation

Protocol Compatibility

MCP (Model Context Protocol)

CompText DSL v1.1 is fully compatible with the MCP November 2025 Specification:

  • JSON-RPC 2.0 protocol
  • Tool definitions and invocations
  • Resource access with @ syntax
  • Async Tasks primitive
  • OAuth 2.1 authorization

Codex Skills

CompText DSL v1.1 supports OpenAI Codex Agent Skills:

  • $skill-name invocation syntax
  • SKILL.md generation
  • Skill composition and pipelines
  • AGENTS.md integration

Version History

Version Date Highlights
v1.1.0 Jan 2026 MCP Nov 2025 & Codex Skills alignment
v1.0.0 Dec 2025 Initial release

Contributing

Contributions are welcome! Please see our Contributing Guidelines and Code of Conduct.

Security

For security issues, please see our Security Policy.

License

MIT License - see LICENSE

Citation

If you use CompText DSL in your research, please cite:

@software{comptext-dsl,
  title = {CompText DSL},
  author = {ProfRandom92},
  year = {2025},
  url = {https://github.com/ProfRandom92/comptext-dsl}
}

Resources:

About

πŸ“ CompText Domain-Specific Language - Token-efficient communication language for LLM interactions

Topics

Resources

License

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors