This is a simple irc client.

1. config file driven connections
2. ssl support
3. password from kernel keyring
4. connection output to a single file
5. flexible regexp based output to
   1. files/pipes
   2. shell-out programs
6. simple input api over pipe

server:
  host: irc.freenode.net
  port: 6697
  ssl: true
  password: keyring irc
  nick: goonie
  channels:
    - #ubuntu
    - #chat
    - #privgroup secret
    - #meeting keyring meetingchan
config:
  input:
    type: named [ || abstract ]
    path: $HOME/.irc-in
  output: default

Input by default will be over standard input. If the config file lists an alternate input location, it will interpreted as a unix socket. If 'input' is specifed as 'default', then it will be a unix socket named $HOME/.cache/gic/${server}/in.

By default, all output goes to standard output, unless 'quiet' flag is given.

If output is set to "default", then the output path will be $HOME/.cache/gic/${server}. Under that path will be (at least) a file called 'out.sql' which will contain all output for the server.

Parsers list rules and destination files or programs to flexibly handle irc events. Rules include:

1. pm [ all | first | username ]
2. mention
3. regexp (all lines matching the listed regexp)

Destinations can be specific named files, filenames built from the rule name, or programs to shell out to, which will receive the triggering line as standard input.

Planned examples:

1. gic [ -f config ] [ serve ]

Simply starts a gic instance.

If no arguments are given, then 'serve' is implied. This command connects to the irc server and serves as the main gic process. All other commands will use this serving instance to do their work.

Over stdin or the input socket you can get a simple readline based interaction, i.e. "c #ubuntu" will choose only channel #ubuntu for output, "t" will show a tail view, etc.

All configured forwarders (i.e. to jabber etc) will be activated.

1. gic [ -f config ] -c #channel [ -c #channel ... ]

Show a two-pane-per-channel curses view, with a 3-line pane at bootom for input and the rest for channel output. When channel starts with # it is a channel, when it starts with @ it is a special name, so far pm or hilight, and otherwise it is a username.

1. gic [ -f config ] -t [ chanlist ] [ -t [ chanlist ] ]

Show a tail view of the listed chanlists. A chanlist is a comma separated list of channels and names. Each -t entry results in a multitail pane. So -t #ubuntu* -t myfriend -t @hilight will show three tail panes, one for all channels beginning with 'ubuntu', one for pms with myfriend, and one for all hilights (pms and mentions).

1. gic [ -f config ] grep [ -c chanlist ] [ -S startdate ] [ -U untildate ] regexp

Grep the logs.