feat: add open command for opening directories as projects

.env.example

@@ -69,6 +69,14 @@ OPENCODE_MODEL_ID=big-pickle
 # raw = show assistant replies as plain text
 # MESSAGE_FORMAT_MODE=markdown
 
+# Directory Browser Roots (optional)
+# Comma-separated list of paths that /open is allowed to browse.
+# Supports ~ for home directory. Defaults to ~ when not set.
+# Examples:
+#   OPEN_BROWSER_ROOTS=~/projects
+#   OPEN_BROWSER_ROOTS=~/projects,~/work,/opt/repos
+# OPEN_BROWSER_ROOTS=
+
 # Code File Settings (optional)
 # Maximum file size in KB to send as document (default: 100)
 # CODE_FILE_MAX_SIZE_KB=100

PRODUCT.md

@@ -168,6 +168,6 @@ Open tasks for upcoming iterations:
 
 Optional or longer-term enhancements:
 
-- [ ] Create new OpenCode projects directly from Telegram
+- [x] Create new OpenCode projects directly from Telegram
 - [ ] Add project file browsing helpers (for example, `ls` and `open` flows)
 - [ ] Add a bot settings command with in-chat UI

README.md

@@ -109,6 +109,7 @@ opencode-telegram config
 | `/abort`          | Abort the current task                                  |
 | `/sessions`       | Browse and switch between recent sessions               |
 | `/projects`       | Switch between OpenCode projects                        |
+| `/open`           | Add a project by browsing directories                   |
 | `/tts`            | Toggle audio replies                                    |
 | `/rename`         | Rename the current session                              |
 | `/commands`       | Browse and run custom commands                          |
@@ -161,6 +162,7 @@ When installed via npm, the configuration wizard handles the initial setup. The
 | `BOT_LOCALE`                    | Bot UI language (supported locale code, e.g. `en`, `de`, `es`, `fr`, `ru`, `zh`)                             |    No    | `en`                     |
 | `SESSIONS_LIST_LIMIT`           | Sessions per page in `/sessions`                                                                             |    No    | `10`                     |
 | `PROJECTS_LIST_LIMIT`           | Projects per page in `/projects`                                                                             |    No    | `10`                     |
+| `OPEN_BROWSER_ROOTS`            | Comma-separated paths `/open` is allowed to browse (supports `~`)                                            |    No    | `~` (home directory)     |
 | `COMMANDS_LIST_LIMIT`           | Commands per page in `/commands`                                                                             |    No    | `10`                     |
 | `TASK_LIMIT`                    | Maximum number of scheduled tasks that can exist at once                                                     |    No    | `10`                     |
 | `BASH_TOOL_DISPLAY_MAX_LENGTH`  | Maximum displayed length for `bash` tool commands in Telegram summaries; longer commands are truncated       |    No    | `128`                    |

src/bot/commands/definitions.ts

@@ -33,6 +33,7 @@ const COMMAND_DEFINITIONS: BotCommandI18nDefinition[] = [
   { command: "commands", descriptionKey: "cmd.description.commands" },
   { command: "opencode_start", descriptionKey: "cmd.description.opencode_start" },
   { command: "opencode_stop", descriptionKey: "cmd.description.opencode_stop" },
+  { command: "open", descriptionKey: "cmd.description.open" },
   { command: "help", descriptionKey: "cmd.description.help" },
 ];