Skip to content

Latest commit

 

History

History
35 lines (27 loc) · 1.25 KB

MIGRATION.md

File metadata and controls

35 lines (27 loc) · 1.25 KB

Migration Guide: v1.x -> v2.0.0

This guide covers the breaking changes when moving from the legacy frogiverse builds to tgcli v2.

CLI rename

  • Old command: frogiverse
  • New command: tgcli
  • npm package: @kfastov/tgcli

Store location

  • Default store moved from ./data to the OS app-data directory:
    • macOS: ~/Library/Application Support/tgcli
    • Linux: $XDG_DATA_HOME/tgcli (fallback ~/.local/share/tgcli)
    • Windows: %APPDATA%\\tgcli
  • Override with TGCLI_STORE.
  • The --store CLI flag is removed. Use TGCLI_STORE instead.

Credentials storage

  • Telegram credentials now live in config.json inside the tgcli store.
  • .env loading is removed; use tgcli auth to set credentials.

If you have an existing ./data store, you can either:

  • Move it into the new tgcli store directory, or
  • Keep it in place and set TGCLI_STORE=./data.

MCP tool surface

Legacy message tools were removed in favor of a unified interface:

  • Use messagesList, messagesSearch, messagesGet, messagesContext.
  • Select archive/live sources with source=archive|live|both.

See docs/mcp-tools.md for the full current tool list.

Server startup

  • Recommended: tgcli server (new CLI command).
  • npm start still works for local development.