Initial commit

skills/code-pointer/references/cli_basics.md

@@ -0,0 +1,118 @@
+# VSCode CLI Basics
+
+Core syntax and essential usage for opening files at specific positions.
+
+## Primary Command: `-g` / `--goto`
+
+**Syntax:**
+```bash
+code -g <file:line[:character]>
+code --goto <file:line[:character]>
+```
+
+**Format:**
+- `file` - Absolute or relative file path
+- `line` - Line number (1-indexed, first line is 1)
+- `character` - Optional column position (0-indexed, first column is 0)
+
+## Basic Examples
+
+### Line Only
+```bash
+# Open file at line 10
+code -g myfile.js:10
+
+# Open file at line 42
+code -g src/app.js:42
+```
+
+### Line and Column
+```bash
+# Open at line 10, column 5
+code -g myfile.js:10:5
+
+# Open at line 42, column 15
+code -g src/index.ts:42:15
+```
+
+### Shorthand (No Flag)
+```bash
+# The -g flag is optional
+code myfile.js:10
+code src/app.js:42:10
+```
+
+## Line and Column Numbering
+
+**Lines are 1-indexed:**
+- Line 1 is the first line
+- Line 10 is the tenth line
+
+**Columns are 0-indexed:**
+- Column 0 is the first character
+- Column 10 is the eleventh character
+
+**Example:**
+```bash
+# Line 5, column 0 (first character of line 5)
+code -g file.js:5:0
+
+# Line 5, column 10 (eleventh character of line 5)
+code -g file.js:5:10
+```
+
+## Path Handling
+
+### Relative Paths
+```bash
+# Resolves from current working directory
+code -g src/app.js:42
+code -g ../other-project/file.js:10
+```
+
+### Absolute Paths
+```bash
+# Always reliable, no dependency on current directory
+code -g /home/user/project/src/app.js:42
+code -g /Users/mae/Documents/code/main.py:100
+```
+
+### Paths with Spaces
+```bash
+# Must be quoted (single or double quotes)
+code -g "my project/src/app.js:42"
+code -g 'path with spaces/file.js:10'
+
+# Unquoted will fail
+code -g my project/src/app.js:42  # ❌ Error
+```
+
+## Non-existent Files
+
+VSCode will create an empty file if the path doesn't exist:
+
+```bash
+# If newfile.js doesn't exist, VSCode creates it
+code -g newfile.js:10
+
+# Cursor will be at line 10 when user starts editing
+```
+
+## Full `code --help` Reference
+
+```
+Usage: code [options] [paths...]
+
+Options
+  -g --goto <file:line[:character]> Open a file at the path on the specified
+                                    line and character position.
+  -n --new-window                   Force to open a new window.
+  -r --reuse-window                 Force to open in already opened window.
+  -w --wait                         Wait for files to be closed before returning.
+  -d --diff <file> <file>           Compare two files.
+  -m --merge <path1> <path2> <base> <result>
+                                    Perform a three-way merge.
+  --profile <profileName>           Opens with the given profile.
+  --user-data-dir <dir>             Specifies user data directory.
+  -h --help                         Print usage.
+```