Skip to content

kstost/cokacdir

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

244 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

COKACDIR

Your coding agent, already in use — on Telegram.

cokacdir is not an AI agent — it does not include an LLM or reasoning engine. Instead, it delegates tasks to the coding agent you are already using (Claude Code, Codex CLI, Gemini CLI, OpenCode) and lets you control it from Telegram. Just send a message to the bot, and the agent will handle code execution, file editing, shell commands, and real-time streaming of results — from your phone or any device with Telegram installed.

It runs within each agent’s existing subscription (or free tier), so there are no additional API costs.

Quick Start

macOS / Linux:

curl -fsSL https://cokacdir.cokac.com/manage.sh | bash && cokacctl

Windows (run PowerShell as Administrator):

irm https://cokacdir.cokac.com/manage.ps1 | iex; cokacctl

Running the command will open the cokacdir management TUI. Then:

  1. Press i to install cokacdir
  2. After installation completes, enter your Telegram bot token (create one via @BotFather)
  3. Press s to start the server

That’s it — open Telegram and start chatting with your bot.

Key Features

  • Blazing-fast performance: Written in Rust for maximum performance. A single binary (15–20MB depending on platform), optimized with LTO and strip.
  • AI-powered commands: Natural-language coding and file management powered by Claude, Codex, Gemini, and OpenCode. Press . and describe what you want done.
  • Multi-panel navigation: A dynamic multi-panel interface for efficient file management
  • Keyboard-first: Full keyboard navigation for power users
  • Built-in editor: File editing with syntax highlighting for more than 20 languages
  • Image viewer: View images directly in the terminal (Kitty, iTerm2, Sixel protocols), with zoom and pan support
  • Process manager: Monitor and manage system processes with sortable columns
  • File search: Recursive file search by name pattern
  • Diff: Side-by-side comparison of folders and files
  • Git integration: Built-in git status, commit, log, branch management, and diff between commits
  • Remote SSH/SFTP: Explore remote servers over SSH/SFTP with saved profiles
  • File encryption: AES-256 encryption with configurable chunk splitting
  • Duplicate file detection: Detect and manage duplicate files using hash-based comparison
  • Telegram bot: Remotely control AI coding sessions through Telegram with streaming output
  • Customizable themes: Light and dark themes with full JSON-based color customization

Community

Telegram group for tips, updates, and support: @cokacvibe

Documentation

For AI provider setup, keyboard shortcuts, and detailed documentation, visit: https://cokacdir.cokac.com

Telegram Bot

Features:

  • Multi-provider support (Claude, Codex, Gemini, OpenCode) with real-time streaming
  • Session persistence and cross-provider session interpretation
  • Scheduled tasks using cron expressions or absolute time
  • Group chat support where multiple bots share context
  • Bot-to-bot messaging for multi-agent workflows
  • File upload/download, tool management, debug logging

Commands: /start, /stop, /clear, /help, /session, /pwd, /model, /down, /instruction, /instruction_clear, /allowed, /allowedtools, /availabletools, /context, /query, /public, /direct, /setpollingtime, /debug, /silent

Supported Platforms

  • macOS (Apple Silicon & Intel)
  • Linux (x86_64 & ARM64)
  • Windows (x86_64 & ARM64)

License

MIT License

Author

cokac monogatree@gmail.com

Homepage: https://cokacdir.cokac.com

Disclaimer

THIS SOFTWARE IS PROVIDED “AS IS,” WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NON-INFRINGEMENT.

IN NO EVENT SHALL THE AUTHOR, COPYRIGHT HOLDERS, OR CONTRIBUTORS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN CONNECTION WITH THE SOFTWARE OR THE USE OF THE SOFTWARE.

This includes, but is not limited to:

  • Data loss or corruption
  • System damage or malfunction
  • Security breaches or vulnerabilities
  • Financial loss
  • Direct, indirect, incidental, special, punitive, or consequential damages

The user assumes full responsibility for all consequences arising from the use of this software, whether such use was intended, authorized, or foreseeable.

ALL RISKS ASSOCIATED WITH USE ARE BORNE BY THE USER.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors