TELA-CLI Command Reference

Complete alphabetical reference for all TELA-CLI commands.

Command Categories

• System Commands - exit, help, info, list
• Network & Connection - endpoint, wallet, balance
• Content Discovery - search (all variants)
• Content Management - clone, serve, shutdown
• Deployment - install-doc, install-index, update-index, rate
• File Operations - file-info, file-shard, file-diff, mv, rm
• Gnomon Indexer - gnomon (all subcommands)
• MOD Operations - mods, mod-info, set-var, delete-var, sc-execute
• Settings - page-size, port-start, max-servers, updates, browser, colors

System Commands

exit / quit

Close TELA-CLI application.

Usage:

» exit

Aliases: exit, quit, Ctrl+C

help

Display list of available commands.

Usage:

» help

Output: Complete command list with descriptions

info

Show application information and current settings.

Usage:

» info

Displays:

• Network and daemon endpoint
• Gnomon status
• Wallet connection status
• Active servers count
• Current settings (page-size, port-start, etc.)

Example Output:

Network: simulator
Endpoint: 127.0.0.1:20000
Gnomon: Online (15,234 blocks indexed)
Wallet: Connected (Height: 15,234)
Active Servers: 3/20
Settings:
  - Page Size: 20
  - Port Start: 8082
  - Max Servers: 20
  - Updates: true
  - Browser: true

list

List all currently running TELA servers.

Usage:

» list

Output: Server name, SCID, URL, and status for each running server

Example:

Active TELA Servers (3/20):
1. myapp.tela - http://localhost:8082 (SCID: abc123...)
2. explorer.tela - http://localhost:8083 (SCID: def456...)
3. Local: ./project - http://localhost:8084

Network & Connection

endpoint

Set or change daemon endpoint connection.

Usage:

# Quick network selection
» endpoint simulator    # 127.0.0.1:20000
» endpoint testnet      # 127.0.0.1:40402
» endpoint mainnet      # 127.0.0.1:10102
» endpoint remote       # node.derofoundation.org:11012
 
# Custom endpoint
» endpoint 192.168.1.100:10102
 
# Close connection
» endpoint close

Networks:

• simulator - Local testing with free DERO
• testnet - Test network for safe experimentation
• mainnet - Production network
• remote - Public DERO node (when you don't run local daemon)

wallet

Open or close a DERO wallet file.

Usage:

# Open wallet
» wallet /path/to/wallet.db
Enter wallet password » ****
 
# Open wallet (with path prompt)
» wallet
Enter wallet file path » /path/to/wallet.db
Enter wallet password » ****
 
# Close wallet
» wallet close

Required for: install-doc, install-index, update-index, rate, set-var, delete-var

balance

View connected wallet's balances.

Usage:

» balance

Output:

Wallet Balance:
DERO: 123.45678
Height: 15,234
Locked: 0.00000

Content Discovery

search all

Search all TELA SCIDs in Gnomon database.

Usage:

» search all

Filters: Respects min-likes setting

search scid

Search by specific SCID.

Usage:

» search scid abc123def456...
 
# View SCID variables
» search scid vars abc123def456...

Output: Full contract information including DOCs, headers, metadata

search docs

Search TELA-DOC contracts.

Usage:

# All DOCs
» search docs
 
# DOCs by type
» search docs HTML
» search docs JS
» search docs CSS
» search docs JSON
» search docs MD
» search docs STATIC

search indexes

Search all TELA-INDEX contracts.

Usage:

» search indexes

Output: List of INDEX contracts with metadata

search libs

Search dURLs tagged as libraries (ending in .lib).

Usage:

» search libs

Output: TELA libraries available for reuse

search durl

Search by dURL identifier.

Usage:

» search durl myapp.tela

search author

Search by author address.

Usage:

» search author deto1qy...

Output: All content created by that wallet

search key / search value

Search by variable key or value stored in contracts.

Usage:

# Find contracts with specific key
» search key var_meta_category
 
# Find contracts with specific value
» search value "Productivity"

search code

View smart contract code by SCID.

Usage:

» search code abc123def456...

Output: Raw smart contract code

search line

Search for specific line of code across all contracts.

Usage:

» search line "Function InitializePrivate"

Output: All contracts containing that code line

search ratings

View ratings for a specific SCID.

Usage:

» search ratings abc123def456...
 
# Filter by height
» search ratings abc123def456... 12345

Output: All ratings with addresses and scores

search my

Search your own deployed content (requires wallet).

Usage:

# Your DOCs
» search my docs
» search my docs HTML
 
# Your INDEXs
» search my indexes

Note: min-likes filter does NOT apply to "my" searches

search min-likes

Set minimum rating filter for search results.

Usage:

# Filter high-quality content (70%+ positive ratings)
» search min-likes 70
 
# Show all content
» search min-likes 0

Range: 0-99 (percentage)

search exclude

Manage search exclusion filters.

Usage:

# View current exclusions
» search exclude view
 
# Add exclusion (excludes SCIDs with "test" in dURL)
» search exclude add test
 
# Remove exclusion
» search exclude remove test
 
# Clear all exclusions
» search exclude clear

Content Management

clone

Clone TELA content to local files.

Usage:

# Clone latest version
» clone abc123def456...
 
# Clone specific version/commit
» clone abc123def456...@txid123...

Cloned to: datashards/clone/[dURL]/

Example:

» clone abc123...
Cloning: myapp.tela
Files cloned to: datashards/clone/myapp.tela/
  - index.html
  - style.css
  - app.js

serve

Serve TELA content locally.

Usage:

# Serve by SCID
» serve abc123def456...
 
# Serve local directory (for testing)
» serve local ./my-project

Access: Opens on http://localhost:[port (opens in a new tab)] (default 8082)

Example:

» serve abc123...
Serving: myapp.tela
URL: http://localhost:8082

shutdown

Stop running servers.

Usage:

# Shutdown specific server by name
» shutdown myapp.tela
 
# Shutdown all servers
» shutdown all
 
# Shutdown only TELA servers (keeps local)
» shutdown tela
 
# Shutdown only local directory servers
» shutdown local

Deployment

install-doc

Deploy a TELA-DOC smart contract.

Usage:

# Interactive prompts
» install-doc
 
# With file path
» install-doc ./index.html

Prompts:

1. Confirm password
2. Enter DOC file path (if not provided)
3. Enter DOC description
4. Enter DOC icon
5. Enter DOC dURL
6. Enter DOC subDir
7. Enter DOC install ringsize
8. Confirm DOC install

Output: DOC install TXID

Requires: Connected wallet

install-index

Deploy a TELA-INDEX smart contract.

Usage:

# Interactive prompts
» install-index
 
# With name
» install-index "My TELA App"

Prompts:

1. Confirm password
2. Enter INDEX name (if not provided)
3. Enter INDEX description
4. Enter INDEX icon
5. Enter INDEX dURL
6. How many total documents?
7. Enter DOC1 SCID, DOC2 SCID, etc.
8. Enter INDEX mods (optional)
9. Enter INDEX install ringsize
10. Confirm INDEX install

Output: INDEX install TXID and SCID

Requires: Connected wallet

update-index

Update an existing TELA-INDEX smart contract.

Usage:

» update-index abc123def456...

Prompts:

1. Confirm password
2. Enter INDEX name (or keep current)
3. Enter INDEX description (or keep current)
4. Enter INDEX icon (or keep current)
5. Enter INDEX dURL (or keep current)
6. How many total documents?
7. Enter DOC SCIDs
8. Add SC TELA-MODs (y/n)
9. Enter INDEX update ringsize
10. Confirm INDEX update

Output: Update TXID

Requires: Connected wallet (must be contract owner)

rate

Rate a TELA smart contract.

Usage:

» rate abc123def456...
Enter rating (0-99) » 85
Rating is: 85  Very good (Benevolent)
Confirm rating (y/n) » y

Range: 0-99

• 0-9: Do not use → Broken
• 10-49: Major → Minor issues
• 50-69: Average
• 70-89: Good → Very good
• 90-99: Exceptional

Requires: Connected wallet

File Operations

file-info

Get file information and statistics.

Usage:

» file-info ./index.html

Output:

File: index.html
Size: 15,234 bytes (14.88 KB)
Lines: 245
Type: HTML
Status: ✅ Under 18KB limit
Recommendation: Consider compression at deployment

file-shard

Create DocShard files from large source file.

Usage:

» file-shard ./large-file.js

Output:

Creating DocShards from: large-file.js
Shard size: 17,500 bytes
Created shards:
  - large-file-1.js (17,500 bytes)
  - large-file-2.js (17,500 bytes)
  - large-file-3.js (8,234 bytes)
Total: 3 shards

Purpose: Split files >18KB into multiple deployable pieces

file-construct

Reconstruct original file from DocShard files.

Usage:

» file-construct ./large-file-1.js

Output:

Constructing from DocShards...
Found 3 matching shards
Reconstructed: large-file.js (43,234 bytes)

file-diff

Compare two files line-by-line.

Usage:

» file-diff ./v1/index.html ./v2/index.html

Output: Line-by-line differences with additions/deletions highlighted

scid-diff

Compare two smart contracts.

Usage:

» scid-diff abc123... def456...

Output: Differences between two deployed contracts

mv

Move files or directories (within clone directory only).

Usage:

» mv source destination

Example:

» mv datashards/clone/old-name datashards/clone/new-name

Restriction: Only works within datashards/clone/ directory

rm

Remove files or directories (within clone directory only).

Usage:

» rm source

Example:

» rm datashards/clone/old-project

Restriction: Only works within datashards/clone/ directory

Gnomon Indexer

gnomon start

Start the Gnomon indexer.

Usage:

» gnomon start

Output:

Starting Gnomon indexer...
Syncing blocks...
Indexed: 15,234/15,234 blocks
Gnomon online: [G:▲]

Requires: Daemon connection

gnomon stop

Stop the Gnomon indexer.

Usage:

» gnomon stop

gnomon resync

Reset and resync Gnomon database.

Usage:

» gnomon resync

Action:

1. Stops Gnomon if running
2. Deletes database for current network
3. Restarts Gnomon with fresh sync

Use When: Database corruption or need fresh index

gnomon add

Manually add SCID(s) to Gnomon database.

Usage:

» gnomon add abc123def456...
 
# Add multiple (space-separated)
» gnomon add abc123... def456... ghi789...

Purpose: Index specific contracts without waiting for full blockchain sync

gnomon clean

Delete Gnomon database for specific network.

Usage:

» gnomon clean simulator
» gnomon clean testnet
» gnomon clean mainnet

Use When: Free up disk space or reset network data

MOD Operations

mods

Display available TELA-MOD information.

Usage:

# Show all MODs
» mods
 
# Show specific MODClass
» mods vs      # Variable Store MODs
» mods tx      # Transfer MODs

Output: MOD names, tags, descriptions, and functions

mod-info

Get detailed information about a specific MOD.

Usage:

» mod-info vsoo
» mod-info txdwd

Output:

MOD: Owner Only Variable Store
Tag: vsoo
Class: Variable Store (vs)
Description: Allows owner to set and delete custom variables
Functions:
  - SetVar(k String, v String)
  - DeleteVar(k String)

set-var

Set a key/value variable on a smart contract.

Usage:

» set-var abc123def456...
Enter key to store » myKey
Enter value for key "myKey" » myValue
Confirm password » ****

Requires:

• Wallet connection
• Contract has Variable Store MOD enabled
• Proper permissions (owner/public depending on MOD)

Example:

# Update app metadata
» set-var your-index-scid
Enter key to store » var_header_name
Enter value » My Updated App Name v2.0

delete-var

Delete a variable from smart contract (owner only).

Usage:

» delete-var abc123def456...
Enter key to delete » myKey
Confirm password » ****

Requires:

• Wallet connection
• Contract owner
• Variable Store MOD enabled

sc-execute

Execute a custom TELA-MOD smart contract function.

Usage:

» sc-execute FunctionName

Advanced: For custom MOD functions beyond standard SetVar/DeleteVar

Settings

page-size

Set maximum results per search page.

Usage:

» page-size 20

Default: 20 Range: 1-100

port-start

Set starting port for TELA servers.

Usage:

» port-start 8082

Default: 8082 Behavior: Servers use sequential ports (8082, 8083, 8084...)

max-servers

Set maximum concurrent TELA servers.

Usage:

» max-servers 20

Default: 20 Range: 1-100

updates

Allow or deny updated TELA content when cloning/serving.

Usage:

# Allow updates (serve latest version)
» updates true
 
# Deny updates (serve original version)
» updates false

Default: true

Effect:

• true: Serves latest commit of INDEX contracts
• false: Serves original version (commit 0)

browser

Auto-open content in default browser when serving.

Usage:

# Enable auto-open
» browser true
 
# Disable auto-open
» browser false

Default: true

colors

Enable or disable terminal colors.

Usage:

» colors true   # Enable colors
» colors false  # Disable colors

Default: true

Status Indicators

The readline prompt shows real-time status:

[01/02/2006 15:04:05]  ⠞⠑⠇⠁ TELA-CLI: [D:▲] [G:▲] [W:1337] [3/20] »

Command Shortcuts

Some commands accept arguments to skip prompts:

# These are equivalent:
» install-doc ./index.html
» install-doc
Enter DOC file path » ./index.html
 
# These are equivalent:
» install-index "My App"
» install-index
Enter INDEX name » My App
 
# These are equivalent:
» endpoint simulator
» endpoint
Enter endpoint » simulator

Interactive Mode Tips

Navigation

• Ctrl+D - Return to main prompt from any sub-prompt
• Ctrl+C - Exit TELA-CLI
• Tab - Auto-complete file paths (when prompted)
• Up/Down Arrows - Command history

Input Helpers

• File paths: Tab completion available
• SCIDs: Paste full 64-character hex string
• Empty input: Press Enter to use defaults (when available)

Best Practices

1. Check status first: Use info to verify connections
2. Test locally: Use serve local before deploying
3. Use simulator: Safe testing environment with free DERO
4. Save SCIDs: Note all deployment SCIDs for future reference
5. Enable Gnomon: Required for search functionality

Command Flow Examples

Typical Development Session

# 1. Start and configure
tela-cli --simulator --gnomon
» info                          # Verify connections
 
# 2. Explore existing content
» search all
» search min-likes 70          # High-quality content
» clone abc123...              # Clone interesting app
 
# 3. Develop locally
» serve local ./my-project     # Test in browser
 
# 4. Deploy to blockchain
» wallet ./dev-wallet.db
» install-doc ./index.html
» install-doc ./style.css
» install-index "My App"
 
# 5. Test deployment
» serve [new-index-scid]
 
# 6. Rate and share
» rate [new-index-scid]

Content Discovery Session

# Start with indexer
tela-cli --mainnet --gnomon
» gnomon start
 
# Filter and search
» search min-likes 80          # Exceptional content only
» search libs                  # Find libraries
» search indexes              # Browse applications
 
# Analyze specific apps
» search scid abc123...
» search scid vars abc123...
» search ratings abc123...
 
# Clone for study
» clone abc123...
» serve abc123...

Related Documentation