File Operations

​

Overview

​

rtk ls

​

Usage

rtk ls [path] [flags]

​

Examples

$ ls -la
drwxr-xr-x  15 user  staff    480 Jan 23 10:00 .
drwxr-xr-x   5 user  staff    160 Jan 23 09:00 ..
-rw-r--r--   1 user  staff   1234 Jan 23 10:00 Cargo.toml
-rw-r--r--   1 user  staff   5678 Jan 23 10:00 README.md
drwxr-xr-x   8 user  staff    256 Jan 23 10:00 src
...
# 45 lines, ~800 tokens

$ rtk ls
📁 my-project/
├── src/ (8 files)
│   ├── main.rs
│   └── lib.rs
├── Cargo.toml
└── README.md

# 12 lines, ~150 tokens (80% savings)

​

Features

• Tree format: Hierarchical directory structure
• Aggregate counts: Shows file counts for directories
• Noise filtering: Automatically excludes .git, node_modules, target, etc.
• Smart truncation: Shows most relevant files first

​

Implementation Details

• Filters noise directories (30+ common patterns)
• Groups files by directory
• Shows permissions, size, and modification time only when relevant
• Preserves exit codes for error handling

​

rtk read

​

Usage

rtk read <file> [options]

​

Options

​

Examples

$ rtk read src/main.rs
# Removes comments, blank lines (70% savings)

$ rtk read src/lib.rs -l aggressive
# Shows only function signatures, type definitions
# Strips function bodies (90% savings)

$ rtk read config.toml -n
# Shows line numbers for reference

​

Supported Languages

• Rust: .rs - Strip comments, docstrings, attributes
• Python: .py - Remove docstrings, comments, decorators
• JavaScript/TypeScript: .js, .ts, .jsx, .tsx - Strip comments, JSDoc
• Go: .go - Remove comments, build tags
• C/C++: .c, .cpp, .h - Strip comments, preprocessor directives
• Java: .java - Remove comments, annotations
• JSON: .json - Preserve structure, optional value stripping

​

Token Savings

​

rtk grep

​

Usage

rtk grep <pattern> <path> [options]

​

Options

​

Examples

$ grep -rn "TODO" .
src/main.rs:42:    // TODO: implement feature
src/lib.rs:18:    // TODO: add tests
tests/integration.rs:91:    // TODO: fix edge case
...
# 50+ lines, ~2000 tokens

$ rtk grep "TODO" .
🔍 3 in 3F:

src/main.rs:42
  // TODO: implement feature

src/lib.rs:18
  // TODO: add tests

tests/integration.rs:91
  // TODO: fix edge case

# 12 lines, ~400 tokens (80% savings)

​

Features

• Grouped by file: Results organized by file path
• Context highlighting: Shows surrounding context for matches
• Smart truncation: Long lines trimmed with ellipsis
• Regex support: Full regex pattern matching (uses rg under the hood)

​

Implementation Details

• Uses ripgrep (rg) for speed, falls back to grep
• Converts BRE alternation \| to PCRE | for compatibility
• Groups results by file with counts
• Strips ANSI color codes for token optimization

​

rtk find

​

Usage

rtk find <pattern> [path] [options]

​

Options

​

Examples

$ find . -name "*.rs"
./src/main.rs
./src/lib.rs
./src/git.rs
./src/grep_cmd.rs
...
# 50+ lines

$ rtk find "*.rs" .
📂 12 matches:

src/
  main.rs, lib.rs, git.rs, grep_cmd.rs
  ls.rs, read.rs, runner.rs, tracking.rs

tests/
  integration.rs, unit.rs

# 10 lines, grouped by directory

​

Native find Compatibility

rtk find . -name "*.rs" -type f -maxdepth 3

• -name <pattern>: File name pattern
• -type <f|d>: File or directory
• -maxdepth <n>: Maximum depth
• -iname <pattern>: Case-insensitive name

• Compound predicates: -not, -or, -and
• Actions: -exec, -delete
• Advanced filters: -regex, -perm, -size, -mtime

​

Features

• Gitignore awareness: Automatically respects .gitignore
• Smart grouping: Groups results by directory
• Glob patterns: Supports * and ? wildcards
• Performance: Uses ignore crate for fast traversal

​

Token Savings Summary

​

Next Steps