brackets-code/brackets-code.1 at main · koder77/brackets-code · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
.TH BRACKETS-CODE 1 "July 2026" "brackets-code 0.6.7" "User Commands"
.SH NAME
brackets-code \- CLI code generator for the Brackets (L1VM) language
.SH SYNOPSIS
.B brackets-code
[OPTIONS] [\fIprompt\fR] [\fIfilename\fR]
.SH DESCRIPTION
Brackets Code converts natural-language prompts into working \fB.l1com\fR programs
for the Brackets (L1VM) virtual machine. It uses a three-tier pipeline: a smart
planner with 166 emitter blocks, keyword-matched templates (31), and a nearest-
neighbor vector search fallback.
.SH OPTIONS
.TP
.B \-\-help, \-h
Show help message and exit.
.TP
.B \-\-list, \-l
List all available templates.
.TP
.B \-\-validate, \-v
Generate and compile-check via l1pre \(rarr l1com.
.TP
.B \-\-self-test, \-t
Run built-in self-test (requires L1VM toolchain for validation).
.TP
.B \-\-batch \fIfile\fR
Process prompts line-by-line from a file.
.TP
.B \-\-search \fIquery\fR
Vector search over example code.
.TP
.B \-\-learn \fIfile\fR [\fIkeywords\fR] [\fIdescription\fR]
Learn new pattern from a .l1com file.
.TP
.B \-\-forget \fIpattern-id\fR
Forget a learned pattern.
.TP
.B \-\-list-learned, \-L
List learned patterns.
.TP
.B \-\-verbose
Show emitter selection scores.
.TP
.B \-\-out-dir \fIdir\fR
Output directory for generated files.
.TP
.B \-\-l1vm-root \fIpath\fR
L1VM installation root (for \-\-validate).
.TP
.B \-\-bash-completion
Print bash completion script.
.TP
.B \-\-dry-run
Print generated code to stdout instead of writing to a file.
.SH EXAMPLES
.TP
brackets-code "hello world"
Generate a hello world program.
.TP
brackets-code "calculate factorial of 7" fact.l1com
Generate factorial program, save to fact.l1com.
.TP
echo "read 5 numbers and sort them" | brackets-code -
Pipe mode: read prompt from stdin.
.TP
brackets-code \-\-validate "fizzbuzz"
Generate and validate with l1pre/l1com.
.TP
brackets-code \-\-search "sort numbers"
Search example code for sort-related programs.
.SH FILES
.TP
.I synonyms.txt
External synonym table for fuzzy matching. Edit to add new word mappings without recompilation.
.TP
.I ~/.brackets-code/learned/
Directory for user-learned patterns.
.SH ENVIRONMENT
.TP
.B L1VM_ROOT
Path to L1VM installation (used by \-\-validate).
.TP
.B L1VM_INCLUDE
Path to L1VM include directory (overrides L1VM_ROOT/include/).
.SH BUGS
Report issues at https://github.com/anomalyco/opencode/issues
.SH LICENSE
GNU General Public License v3 or later.
.SH SEE ALSO
l1pre(1), l1com(1), l1asm(1), l1vm(1)